Obter GPS

GET

/gps

Lista, de forma paginada, as posições GPS enviadas por um equipamento no período.

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 Cliente.

⚠️ 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.

startDate e endDate são lidos no fuso do usuário do token; gpsTime volta em UTC. Sem a permissão de posições: 403.

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

🟠422Unprocessable Entity

🟠429Too Many Request

🔴500Internal server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.cloud-services.yuv.com.br/gps' \
--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",
            "gpsLatitude": "-23.550520",
            "gpsLongitude": "-46.633308",
            "gpsIgnition": 1,
            "gpsAddress": "Av. Paulista, 1000 - São Paulo/SP",
            "gpsTime": "2025-05-20 07:42:30",
            "gpsSpeed": 54,
            "driverId": null,
            "driverName": null,
            "driverIdentifier": null
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 1
}

Modificado em 2026-10-15 18:07:52

Obter GPS

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras