Primeiros Passos

Neste guia você vai fazer sua primeira chamada à API Frota162 em menos de 10 minutos. Vamos direto ao essencial, passo a passo.

---

O que você vai conseguir ao final

• Credenciais configuradas e funcionando
• Uma chamada real à API retornando dados da sua frota
• Clareza sobre como explorar o restante da documentação

---

1. Obtenha suas credenciais

Para acessar a API você precisa de duas chaves — um ACCESS_TOKEN e uma SECRET_KEY. Veja como ativá-las:

1. Faça login com seu usuário e senha no painel Frota162:

Ambiente	URL
Teste	https://sandbox.frota162.com.br/login
Produção	https://sistema.frota162.com.br/login

2. Acesse Configurações → Usuários no menu lateral.

3. Selecione a opção de edição do seu próprio usuário.

4. Na seção Credenciais de API, utilize os botões "Gerar Token" e "Gerar Secret Key" para criar as credenciais de acesso.

5. Para visualizar as credenciais geradas, clique em "Ver". Para copiar os valores, utilize o botão "Copiar".

Segurança

Guarde as duas chaves em local seguro. Nunca as coloque diretamente no código-fonte — use variáveis de ambiente ou um gerenciador de segredos.

---

2. Faça sua primeira chamada

Use o ambiente de homologação para desenvolver e testar — dados fictícios, sem risco de afetar informações reais.

Base URL de homologação: https://apidev.v1.frota162.com.br

Via linha de comando (cURL)

A API usa autenticação HMAC-SHA256. Toda requisição precisa de dois headers:

Authorization: Basic {ACCESS_TOKEN}
Key: {HMAC_SIGNATURE}

A assinatura é calculada assim: HMAC_SIGNATURE = HMAC-SHA256(ACCESS_TOKEN, SECRET_KEY)

ACCESS_TOKEN="seu_token_aqui"
SECRET_KEY="sua_chave_secreta"

# Calcular a assinatura HMAC
HMAC_KEY=$(echo -n "$ACCESS_TOKEN" | openssl dgst -sha256 -hmac "$SECRET_KEY" | awk '{print $2}')

# Chamar a API — listar veículos
curl -X GET \
  "https://apidev.v1.frota162.com.br/key/list-cars?pagination[page]=1&pagination[perpage]=10" \
  -H "Authorization: Basic $ACCESS_TOKEN" \
  -H "Key: $HMAC_KEY"

Ver exemplo em Node.js

const crypto = require('crypto');

const accessToken = process.env.FROTA_ACCESS_TOKEN;
const secretKey   = process.env.FROTA_SECRET_KEY;

const hmacKey = crypto
  .createHmac('sha256', secretKey)
  .update(accessToken)
  .digest('hex');

const response = await fetch(
  'https://apidev.v1.frota162.com.br/key/list-cars?pagination[page]=1&pagination[perpage]=10',
  {
    headers: {
      'Authorization': `Basic ${accessToken}`,
      'Key': hmacKey,
    },
  }
);

const data = await response.json();
console.log(data.cars.total, 'veículos encontrados');

---

3. Confira a resposta

O que você vai receber: uma lista paginada dos veículos cadastrados na sua conta. O campo total indica quantos veículos existem no total, e data traz os registros daquela página. O campo "error": false confirma que a chamada foi bem-sucedida.

{
  "cars": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "car_plate": "ABC1234",
        "renavam": "00123456789",
        "brand": "TOYOTA",
        "model": "COROLLA",
        "active": "1"
      }
    ],
    "total": 42,
    "per_page": "10",
    "last_page": 5
  },
  "error": false,
  "code": "fbk_200"
}

---

E se der erro?

O erro mais comum no início é de autenticação:

{
  "message": "Não autorizado",
  "error": true,
  "code": "fbk_001"
}

Checklist de verificação:

1. O ACCESS_TOKEN está correto? (sem espaços extras no início ou final)
2. A SECRET_KEY é exatamente a mesma exibida no painel?
3. O cálculo do HMAC está usando sha256? (não sha1, não md5)
4. Você está apontando para o ambiente de homologação (apidev)?

Para a lista completa de códigos de erro, consulte Tratamento de Erros.

---

Próximos passos

Quero...	Ir para...
Entender a autenticação em detalhes	Autenticação HMAC
Receber eventos em tempo real	Guia de Webhooks
Explorar por módulo	Veículos · Condutores · Empresas · Viagens · Multas

---

Travou em algum passo? A gente ajuda — suporte@frota162.com.br