API —— Eliminazione della mappa Spatial Map
Questa interfaccia viene utilizzata per eliminare definitivamente i dati della mappa spaziale (Spatial Map) specificata tramite mapId.
1. Informazioni di base dell'interfaccia
- Indirizzo interfaccia:
https://armap-api-<cn1,na1>.easyar.com/map/{mapId} - Metodo richiesta:
DELETE - Formato risposta:
*/*(solitamenteapplication/json)
2. Metodo di autenticazione
Questa interfaccia supporta due modalità di autenticazione:
- Autenticazione basata su Token:
- Header:
Authorization: [token] - Parametri: deve includere
appId.
- Header:
- Autenticazione basata su firma (Signature):
- Parametri: deve includere
appId,apiKey,timestamp,signature. - L'algoritmo dettagliato per il calcolo della firma è disponibile in Metodo di firma API Key.
- Parametri: deve includere
3. Parametri di richiesta
3.1 Parametri percorso (Path Parameters)
| Nome parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| mapId | String | Sì | Identificatore univoco della mappa spaziale (MapId). |
4. Struttura dati di risposta (ARMapDTO)
Quando la richiesta ha successo (statusCode 0), il risultato result conterrà le informazioni istantanee della mappa eliminata.
| Nome campo | Tipo | Descrizione |
|---|---|---|
| mapId | String | Identificatore univoco della mappa. |
| name | String | Nome della mappa. |
| status | String | Stato corrente della mappa. |
| size | Integer (int64) | Dimensione del file della mappa. |
| meta | String | Metadati personalizzati. |
| previewUrl | String | Link per il download dell'anteprima. |
| emeUrl | String | Link alla risorsa EME. |
| md5 | String | Codice di verifica MD5 del file. |
| created | DateTime | Data di creazione. |
| modified | DateTime | Data ultima modifica. |
5. Codice di stato
| Http Code | Significato | Spiegazione |
|---|---|---|
| 200 | OK | Richiesta riuscita, restituisce l'oggetto mappa eliminato. |
| 401 | Unauthorized | Autenticazione fallita, verificare Token o firma. |
| 403 | Forbidden | Accesso non consentito alla risorsa. |
Status Code codici di errore
6. Esempio di risposta (JSON)
{
"statusCode": 0,
"msg": "success",
"timestamp": "2026-01-30T10:00:00Z",
"result": {
"mapId": "string",
"name": "example_map",
"status": "inactive",
"size": 1024
}
}