API —— Spatial Map 맵 삭제
이 인터페이스는 mapId를 통해 지정된 Spatial Map(공간 맵) 데이터를 영구적으로 삭제하는 데 사용됩니다.
1. 인터페이스 기본 정보
- 인터페이스 주소:
https://armap-api-<cn1,na1>.easyar.com/map/{mapId} - 요청 방법:
DELETE - 응답 형식:
*/*(일반적으로application/json)
2. 인증 방식
이 인터페이스는 다음 두 가지 인증 모드를 지원합니다:
- Token 기반 인증:
- 헤더:
Authorization: [token] - 매개변수:
appId를 포함해야 합니다.
- 헤더:
- 서명(Signature) 기반 인증:
- 매개변수:
appId,apiKey,timestamp,signature를 포함해야 합니다. - 서명 계산 상세 알고리즘은 API Key 서명 방법을 참조하십시오.
- 매개변수:
3. 요청 매개변수
3.1 경로 매개변수 (Path Parameters)
| 매개변수 이름 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
| mapId | String | 예 | 공간 맵의 고유 식별자(MapId). |
4. 응답 데이터 구조 (ARMapDTO)
요청이 성공(statusCode가 0)할 경우, 반환 결과 result에는 삭제된 맵의 스냅샷 정보가 포함됩니다.
| 필드 이름 | 유형 | 설명 |
|---|---|---|
| mapId | String | 맵 고유 식별자. |
| name | String | 맵 이름. |
| status | String | 맵 현재 상태. |
| size | Integer (int64) | 맵 파일 크기. |
| meta | String | 사용자 정의 메타데이터. |
| previewUrl | String | 미리보기 이미지 다운로드 링크. |
| emeUrl | String | EME 리소스 링크. |
| md5 | String | 파일의 MD5 체크섬. |
| created | DateTime | 생성 시간. |
| modified | DateTime | 마지막 수정 시간. |
5. 상태 코드
| Http 코드 | 의미 | 설명 |
|---|---|---|
| 200 | OK | 요청 성공, 삭제된 맵 객체 반환. |
| 401 | Unauthorized | 인증 실패, Token 또는 서명을 확인하십시오. |
| 403 | Forbidden | 해당 리소스에 대한 접근 권한이 없습니다. |
Status code 오류 코드
6. 예시 응답 (JSON)
{
"statusCode": 0,
"msg": "success",
"timestamp": "2026-01-30T10:00:00Z",
"result": {
"mapId": "string",
"name": "example_map",
"status": "inactive",
"size": 1024
}
}