API —— Удаление карты Spatial Map
Данный интерфейс используется для безвозвратного удаления указанных данных Spatial Map (пространственной карты) по mapId.
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 Code | Значение | Описание |
|---|---|---|
| 200 | OK | Запрос успешен, возвращен удаленный объект карты. |
| 401 | Unauthorized | Ошибка аутентификации, проверьте токен или подпись. |
| 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
}
}