POST /api/v1/auth/token — Get Bearer Access Token

Use este endpoint para trocar seu client_id e client_secret por um token de acesso Bearer. O token autoriza todas as requisições subsequentes à API e é válido por 3600 segundos (1 hora).

Endpoint

POST https://api.igps.com.br/api/v1/auth/token

Cabeçalhos da Requisição

string

required

Deve ser application/json.

Corpo da Requisição

string

required

O identificador de cliente da sua aplicação, emitido pela iGps.

string

required

O segredo de cliente da sua aplicação, emitido pela iGps. Mantenha este valor privado.

Exemplo de Requisição

curl -X POST https://api.igps.com.br/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

import requests

response = requests.post(
    "https://api.igps.com.br/api/v1/auth/token",
    json={
        "client_id": "YOUR_CLIENT_ID",
        "client_secret": "YOUR_CLIENT_SECRET"
    }
)
data = response.json()
token = data["access_token"]

Resposta (200 OK)

string

required

O token Bearer a ser incluído no cabeçalho Authorization das requisições subsequentes.

string

required

O tipo de token. Sempre Bearer.

integer

required

Número de segundos até o token expirar. Tipicamente 3600 (1 hora).

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Respostas de Erro

Código HTTP	Causa	Resolução
400 Bad Request	`client_id` ou `client_secret` ausente	Inclua ambos os campos no corpo da requisição
401 Unauthorized	Credenciais inválidas	Verifique seu `client_id` e `client_secret`

Nunca inclua seu client_secret em código do lado do cliente (navegador) nem o envie para controle de versão. Armazene-o como variável de ambiente.

Autenticação

Veículos

POST /api/v1/auth/token — Get Bearer Access Token

Endpoint

Cabeçalhos da Requisição

Corpo da Requisição

Exemplo de Requisição

Resposta (200 OK)

Respostas de Erro

​Endpoint

​Cabeçalhos da Requisição

​Corpo da Requisição

​Exemplo de Requisição

​Resposta (200 OK)

​Respostas de Erro

Endpoint

Cabeçalhos da Requisição

Corpo da Requisição

Exemplo de Requisição

Resposta (200 OK)

Respostas de Erro