Faça sua primeira chamada em menos de 2 minutos

Siga os passos abaixo para gerar seu token de acesso e realizar sua primeira chamada à API da Rede Frota. Em poucos minutos, você já terá sua integração funcionando.

1. Obter credenciais OAuth2

  1. Crie sua conta em nosso Portal Developer e assim que sua conta for aprovada

  2. Aguarde a confirmação pelo Time de integração Rede Frota, você vai receber um e-mail

  3. Você já pode continuar para a sua primeira chamada

  4. Após o e-mail de aprovação, acesse Perfil → Subscriptions para encontrar seu client_id e gerar o client_secret que você usará no próximo passo.

2. Gerar o token JWT

Todas as requisições devem incluir um token JWT, obtido previamente na API de autenticação da Rede Frota.

Request

curl -X POST "https://api-homologacao.redefrota.com.br/auth-sso/api/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=SEU_CLIENT_ID&client_secret=SEU_CLIENT_SECRET"

Response

{ 
"accessToken": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSl......9SmgxZ4ow",
"expiresIn": 3600,
"refreshToken": null,
"refreshExpiresIn": 0,
"tokenType": "Bearer"
}

3. Consultar transações

Agora utilize o token retornado para fazer sua primeira chamada

Request

curl -X GET "https://api-homologacao.redefrota.com.br/v1/suppliers/transactions?\
supplier_document=12345678000199&\
start_date=2025-01-01&\
end_date=2025-01-31" \
-H "Authorization: Bearer SEU_TOKEN"

Response 200

{
    "previous_page": 0,
    "next_page": 2,
    "current_page": 1,
    "is_last": false,
    "total_pages": 28,
    "total_items": 543,
    "total_items_page": 20,
    "max_items_per_page": 20,
    "paged": true,
    "data": [
        {
            "vehicle_id": 189247,
            "customer_id": 14589,
            "plate": "AAA-0102",
            "model": null,
            "status": "active",
            "driver_name": null,
            "driver_document": null
        },
        {
            "vehicle_id": 189103,
            "customer_id": 14589,
            "plate": "BXZ-0008",
            "model": "G 440 A6X4 400 A6X2",
            "status": "inactive",
            "driver_name": null,
            "driver_document": null
        }
    ]
}

Response 401 - Token inválido/expirado

{
    "statusCode": 401,
    "message": "Invalid or expired bearer token. Please provide a valid Authorization bearer token."
}

Response 400 - Dados de acessos inválidos

{
    "error": "unauthorized_client",
    "error_description": "Invalid client or Invalid client credentials"
}

4. Interpretar resposta

Se a requisição for bem-sucedida, a API retornará status 200 OK com a lista de veículos:

Response 200

{
    "previous_page": 0,
    "next_page": 2,
    "current_page": 1,
    "is_last": false,
    "total_pages": 28,
    "total_items": 543,
    "total_items_page": 20,
    "max_items_per_page": 20,
    "paged": true,
    "data": [
        {
            "vehicle_id": 189103,
            "customer_id": 14589,
            "plate": "BXZ-0008",
            "model": "G 440 A6X4 400 A6X2",
            "status": "inactive",
            "driver_name": null,
            "driver_document": null
        }
    ]
}

Primeira comunicação foi finalizada

  • A autenticação foi realizada com sucesso

  • O token JWT é válido

  • A API está acessível e respondendo normalmente