Table of Contents

API - Spatial Map 삭제

이 API는 mapId를 통해 지정된 Spatial Map 데이터를 영구적으로 삭제하는 데 사용됩니다.

1. API 기본 정보

  • API endpoint: https://armap-api-<cn1,na1>.easyar.com/map/{mapId}
  • request 메서드: DELETE
  • response 형식: */* (일반적으로 application/json)

2. Authentication

이 API는 다음 두 가지 authentication 모드를 지원합니다.

  1. Token 기반 authentication:
    • Header: Authorization: [token]
    • Parameter: appId를 포함해야 합니다.
  2. Signature 기반 authentication:
    • Parameters: appId, apiKey, timestamp, signature를 포함해야 합니다.
    • signature 계산의 자세한 알고리즘은 API Key signature method를 참조하십시오.

3. request 매개변수

3.1 Path parameters

매개변수 이름 타입 필수 여부 설명
mapId String spatial map의 고유 식별자(MapId).

4. response 데이터 구조 (ARMapDTO)

request가 성공하면(statusCode가 0), 반환되는 result에는 삭제된 map의 snapshot information이 포함됩니다.

필드 이름 타입 설명
mapId String map 고유 식별자.
name String map 이름.
status String map 현재 상태.
size Integer (int64) map 파일 크기.
meta String 사용자 지정 metadata.
previewUrl String preview image 다운로드 링크.
emeUrl String EME resource 링크.
md5 String 파일의 MD5 checksum.
created DateTime 생성 시간.
modified DateTime 마지막 수정 시간.

5. Status codes

Http Code 의미 설명
200 OK request 성공, 삭제된 map object를 반환합니다.
401 Unauthorized authentication 실패, Token 또는 signature를 확인하십시오.
403 Forbidden 이 resource에 접근할 권한이 없습니다.

Status Code error codes

6. response 예시 (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "mapId": "string",
    "name": "example_map",
    "status": "inactive",
    "size": 1024
  }
}