Skip to main content
Antes de integrar a iGps, é útil entender os conceitos-chave que fundamentam a API: como a autenticação funciona, como os veículos são identificados e como os dados de posição são estruturados.

​
Conceitos Principais

Credenciais

Seu client_id e client_secret identificam sua aplicação e são necessários para obter um token de acesso.

Tokens de Acesso

Tokens Bearer de curta duração autorizam as requisições à API. Os tokens são obtidos através do endpoint de autenticação e devem ser incluídos em toda requisição.

Número do Chassi (VIN)

O identificador de 17 caracteres usado para consultar veículos. Cada consulta de posição é resolvida com base em um ou mais números de chassi.

Dados de Posição

Latitude, longitude e timestamp de cada veículo, representando o registro GPS mais recente reportado pelo dispositivo de rastreamento do veículo.

​
Fluxo da Requisição

1

Autentique-se

Sua aplicação envia seu client_id e client_secret para POST /api/v1/auth/token para comprovar sua identidade.
2

Receba um Token Bearer

A iGps valida suas credenciais e retorna um token Bearer válido por 1 hora. Armazene esse token para uso em requisições subsequentes.
3

Consulte Posições de Veículos

Sua aplicação envia uma lista de números de chassi (VINs) para POST /api/v1/veiculos/posicoes, incluindo o token Bearer no cabeçalho Authorization.
4

Receba os Dados de Posição

A iGps retorna a posição GPS mais recente conhecida de cada veículo no array resultados, junto com um código de status por veículo.

​
Versionamento

A API iGps é versionada através do caminho da URL (por exemplo, /api/v1/). A versão estável atual é a v1. Mudanças incompatíveis, como remoção de campos ou alteração de formatos de requisição, são sempre introduzidas em uma nova versão da URL, de modo que sua integração existente não será afetada por mudanças futuras.
A iGps retorna a posição mais recente conhecida de cada veículo. A atualização da posição depende do intervalo de reporte do dispositivo de rastreamento do veículo.