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 모드를 지원합니다.
- Token 기반 authentication:
- Header:
Authorization: [token] - Parameter:
appId를 포함해야 합니다.
- Header:
- Signature 기반 authentication:
- Parameters:
appId,apiKey,timestamp,signature를 포함해야 합니다. - signature 계산의 자세한 알고리즘은 API Key signature method를 참조하십시오.
- Parameters:
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
}
}