Table of Contents

API —— Excluir mapa Spatial Map

Esta interface é usada para excluir permanentemente os dados do Spatial Map (mapa espacial) especificado por meio do mapId.

1. Informações básicas da interface

  • Endpoint: https://armap-api-<cn1,na1>.easyar.com/map/{mapId}
  • Método HTTP: DELETE
  • Formato da resposta: */* (normalmente application/json)

2. Método de autenticação

Esta interface suporta dois modos de autenticação:

  1. Baseado em Token:
    • Header: Authorization: [token]
    • Parâmetro: Deve incluir appId.
  2. Baseado em assinatura (Signature):
    • Parâmetros: Deve incluir appId, apiKey, timestamp, signature.
    • Para o algoritmo detalhado de cálculo da assinatura, consulte Método de assinatura API Key.

3. Parâmetros da requisição

3.1 Parâmetros de caminho (Path Parameters)

Nome do parâmetro Tipo Obrigatório Descrição
mapId String Sim Identificador único do mapa espacial (MapId).

4. Estrutura de dados da resposta (ARMapDTO)

Quando a requisição é bem-sucedida (statusCode igual a 0), o resultado result conterá informações de snapshot do mapa excluído.

Nome do campo Tipo Descrição
mapId String Identificador único do mapa.
name String Nome do mapa.
status String Estado atual do mapa.
size Integer (int64) Tamanho do arquivo do mapa.
meta String Metadados personalizados.
previewUrl String URL de download da imagem de pré-visualização.
emeUrl String URL do recurso EME.
md5 String Checksum MD5 do arquivo.
created DateTime Data e hora de criação.
modified DateTime Data e hora da última modificação.

5. Códigos de status

Código HTTP Significado Descrição
200 OK Requisição bem-sucedida, retorna o objeto do mapa excluído.
401 Unauthorized Falha na autenticação, verifique o Token ou a assinatura.
403 Forbidden Sem permissão para acessar este recurso.

Códigos de erro do Status Code

6. Exemplo de resposta (JSON)

{
  "statusCode": 0,
  "msg": "success",
  "timestamp": "2026-01-30T10:00:00Z",
  "result": {
    "mapId": "string",
    "name": "example_map",
    "status": "inactive",
    "size": 1024
  }
}