API —— Spatial Mapの削除
このインターフェースはmapIdを使用して指定されたSpatial Map(空間マップ)データを完全に削除するために使用されます。
1. インターフェース基本情報
- エンドポイント:
https://armap-api-<cn1,na1>.easyar.com/map/{mapId} - HTTPメソッド:
DELETE - レスポンス形式:
*/*(通常はapplication/json)
2. 認証方式
このインターフェースは以下の2つの認証モードをサポートします:
- トークンベース認証:
- ヘッダー:
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 | プレビュー画像ダウンロードURL |
| emeUrl | String | EMEリソースURL |
| md5 | String | ファイルMD5チェックサム |
| created | DateTime | 作成日時 |
| modified | DateTime | 最終更新日時 |
5. ステータスコード
| HTTPコード | 意味 | 説明 |
|---|---|---|
| 200 | OK | リクエスト成功、削除されたマップオブジェクトを返却 |
| 401 | Unauthorized | 認証失敗、トークンまたは署名を確認してください |
| 403 | Forbidden | リソースへのアクセス権限がありません |
ステータスコード エラーコード
6. レスポンス例 (JSON)
{
"statusCode": 0,
"msg": "success",
"timestamp": "2026-01-30T10:00:00Z",
"result": {
"mapId": "string",
"name": "example_map",
"status": "inactive",
"size": 1024
}
}