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 suas transações

Agora utilize o token retornado para fazer sua primeira chamada como Fornecedor.

Request

curl -X GET "https://api-homologacao.redefrota.com.br/v1/suppliers/transactions?\
-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": [
        {
            "transaction_id": 4081505,
            "date": "2025-01-15T10:30:00Z",
            "amount": 882.76,
            "product": "DIESEL S-10",
            "repass_status": "pending",
            "repass_date": "2025-01-31"
            
        },
        {
            "transaction_id": 4081506,
            "date": "2025-01-15T10:30:00Z",
            "amount": 450.00,
            "product": "DIESEL S-500",
            "repass_status": "paid",
            "repass_date": "2025-01-31"
            
        }
    ]
}

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 transações do seu estabelecimento no período informado:

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": [
        {
            "transaction_id": 4081506,
            "date": "2025-01-15T10:30:00Z",
            "amount": 450.00,
            "product": "DIESEL S-500",
            "repass_status": "paid",
            "repass_date": "2025-01-31"
            
        }
    ]
}

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