Rastreamento e DispositivosRelatório de Quilometragem

Relatório de Quilometragem

Obtém o relatório de quilometragem percorrida pelos dispositivos no período.

Requisição HTTP

MétodoCaminho (Path)
GET/api/device/mileage

Parâmetros de Consulta (Query)

ParâmetroTipoObrigatórioDescrição
access_tokenstringtrueO token de acesso.
imeisstringtrueLista de IMEIs de destino, separados por vírgula, no máximo 100 IMEIs por chamada.
begintimelongtrueTempo inicial. O minuto da hora de início só pode ser 0 ou 30, por exemplo 01:00, 02:30.
endtimelongtrueTempo final. O minuto da hora de término só pode ser 0 ou 30, por exemplo 01:00, 02:30.
⚠️

Time restrictions:

  • The begintime is included, endtime is not included.
  • The maximum interval between begintime and endtime is 7 days.
  • The minute of begintime and endtime can only be 0 or 30 (e.g., 01:00, 02:30).

Exemplo

Request URL:

GET https://api.brasilsatgps.com.br/api/device/mileage?access_token={ACCESS_TOKEN}&imeis=358899123456789,355139000000234&begintime=1722816000&endtime=1722859200

Estrutura de Retorno (Schema)

Campo JSONTipo de DadoDescrição
recordArrayLista de objetos de quilometragem dos dispositivos.
record[].imeistringIMEI do dispositivo.
record[].mileagedoubleQuilometragem do dispositivo em km.

Exemplo de Resposta JSON

{
  "record": [
    {
      "imei": "351000091413001",
      "mileage": 338.21
    },
    {
      "imei": "351000091413002",
      "mileage": 500.56
    },
    {
      "imei": "351000091413003",
      "mileage": 280.87
    },
    {
      "imei": "351000091413004",
      "mileage": 621.21
    }
  ],
  "code": 0
}