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 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/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-02 19:54:03

Obter GPS

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras