Obter Deslocamento

GET

/movement

Lista, de forma paginada, os trechos de deslocamento (movimento/parada) de um equipamento no período, com início, fim, duração, distância e velocidade máxima.

Disponível para: Revendedor e Cliente
Rate limit: 80 requisições/minuto (operação pesada)

📌 Esta é a versão da documentação para token de Revendedor.

⚠️ Apesar de ser GET, os filtros são enviados no corpo JSON da requisição (não na query string). O corpo é obrigatório: sem filtros, envie {} (sem corpo a API responde 400).

Revendedor x Cliente

Revendedor: qualquer IMEI do revendedor que esteja vinculado a um ativo.

Cliente: apenas IMEIs de ativos do próprio cliente.

Regras

startDate e endDate no formato AAAA-MM-DD hh:mm:ss.

A paginação é controlada pela API (não há perPage). Use page para navegar.

Os resultados vêm em ordem cronológica crescente.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🟠404Registry not found

🔴500Internal server error

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.cloud-services.yuv.com.br/movement' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "deviceImei": "864993060000000",
    "startDate": "2025-05-20 00:00:00",
    "endDate": "2025-05-20 23:59:59",
    "page": 1
}'

Response Example

200 - Sucesso

{
    "currentPage": 1,
    "data": [
        {
            "assetPrefix": "CAM-01",
            "assetIdentifier": "ABC1D23",
            "startGps": "2025-05-20 07:00:00",
            "startLat": "-23.550520",
            "startLng": "-46.633308",
            "startLocale": "Av. Paulista, 1000 - São Paulo/SP",
            "duration": "00:42:30",
            "endGps": "2025-05-20 07:42:30",
            "endLat": "-23.561414",
            "endLng": "-46.655881",
            "endLocale": "R. Augusta, 500 - São Paulo/SP",
            "event": "Movimento",
            "maximumSpeed": 72,
            "kmTraveled": 12.4,
            "qtyAlarms": 1,
            "driverId": null,
            "driverName": null,
            "driverIdentifier": null
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 1
}

Modificado em 2026-10-02 19:54:13

Obter Deslocamento

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras