Relatório de Quilometragem
Obtém o relatório de quilometragem percorrida pelos dispositivos no período.
Requisição HTTP
| Método | Caminho (Path) |
|---|---|
GET | /api/device/mileage |
Parâmetros de Consulta (Query)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
access_token | string | true | O token de acesso. |
imeis | string | true | Lista de IMEIs de destino, separados por vírgula, no máximo 100 IMEIs por chamada. |
begintime | long | true | Tempo inicial. O minuto da hora de início só pode ser 0 ou 30, por exemplo 01:00, 02:30. |
endtime | long | true | Tempo final. O minuto da hora de término só pode ser 0 ou 30, por exemplo 01:00, 02:30. |
⚠️
Time restrictions:
- The
begintimeis included,endtimeis not included. - The maximum interval between
begintimeandendtimeis 7 days. - The minute of
begintimeandendtimecan only be0or30(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=1722859200Estrutura de Retorno (Schema)
| Campo JSON | Tipo de Dado | Descrição |
|---|---|---|
record | Array | Lista de objetos de quilometragem dos dispositivos. |
record[].imei | string | IMEI do dispositivo. |
record[].mileage | double | Quilometragem 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
}