> ## Documentation Index
> Fetch the complete documentation index at: https://dev.igps.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# API iGps: Rastreamento de Veículos por GPS em Tempo Real pelo Número do Chassi

> A iGps permite consultar a posição GPS em tempo real de veículos pelo número do chassi. Integre o rastreamento de veículos à sua aplicação em minutos.

A iGps é uma API REST que permite obter a posição GPS mais recente de qualquer veículo usando o número do chassi (VIN). Seja para construir um painel de gestão de frotas, uma plataforma de logística ou uma solução de rastreamento personalizada, a iGps fornece dados de localização em tempo real com uma única requisição HTTP. Você pode consultar até **50 veículos por requisição** em uma única chamada em lote, e todos os endpoints são protegidos por **autenticação com token Bearer** para manter seus dados seguros.

## Comece Agora

<CardGroup cols={2}>
  <Card title="Início Rápido" icon="rocket" href="/quickstart">
    Faça sua primeira chamada à API em minutos
  </Card>

  <Card title="Autenticação" icon="key" href="/authentication">
    Obtenha e utilize seu token de acesso
  </Card>

  <Card title="Posições de Veículos" icon="location-dot" href="/concepts/vehicle-positions">
    Entenda o modelo de dados de posição
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/auth/token">
    Referência completa dos endpoints com exemplos
  </Card>
</CardGroup>

## Como Funciona

<Steps>
  <Step title="Obtenha Suas Credenciais">
    Entre em contato com a iGps para receber seu `client_id` e `client_secret`. Essas credenciais identificam sua aplicação de forma única e são necessárias para gerar tokens de acesso.
  </Step>

  <Step title="Obtenha um Token de Acesso">
    Envie seu `client_id` e `client_secret` via POST para `/api/v1/auth/token` para receber um token Bearer. O token é válido por **3600 segundos**. Sua aplicação deve renová-lo antes que expire para evitar interrupções.
  </Step>

  <Step title="Consulte Posições de Veículos">
    Envie até **50 números de chassi** via POST para `/api/v1/veiculos/posicoes`, passando seu token Bearer no cabeçalho `Authorization`. A API retorna as coordenadas GPS mais recentes de cada veículo no lote.
  </Step>
</Steps>

<Note>
  Todas as requisições devem ser feitas via HTTPS. Inclua `Content-Type: application/json` no cabeçalho de cada requisição.
</Note>