Visão geral

A plataforma Declatrack possui uma API REST que retorna, em JSON, a frota completa com a última posição de cada veículo. A integração não exige nenhum desenvolvimento na plataforma — apenas a montagem do cenário abaixo:

O que a Declatrack fornece

• URL base da API (informada junto com as credenciais — nos exemplos abaixo usamos https://plataforma.declatrack.com.br);
• Usuário de integração (e-mail e senha) com acesso somente leitura aos veículos da sua conta;
• Chave de API (user_api_hash) já gerada, para uso direto no Make.

1. Autenticação

Todas as chamadas são autenticadas por um token fixo (user_api_hash) passado como parâmetro de URL. Como a chave já será fornecida pela Declatrack, o passo de login é opcional — serve apenas para obter/renovar a chave:

POST/api/login

curl -X POST "https://plataforma.declatrack.com.br/api/login" \
  -d "username=integracao@suaempresa.com.br" \
  -d "password=SUA_SENHA"

Resposta:

{ "status": 1, "user_api_hash": "$2y$10$AbCdEf..." }

Guarde o user_api_hash — ele não expira a cada sessão e será usado em todas as demais chamadas. Não é necessário refazer login no cenário do Make.

2. Consultar a frota — get_devices

Endpoint principal da integração. Retorna todos os veículos da conta, agrupados, com dados cadastrais e — quando solicitado via includes — a última posição, sensores e motorista.

GET/api/get_devices

curl "https://plataforma.declatrack.com.br/api/get_devices?user_api_hash=SUA_CHAVE&includes[]=position&includes[]=driver"

Estrutura da resposta

A resposta é uma lista de grupos; os veículos ficam no array items de cada grupo:

[
  {
    "id": 0,
    "title": "Sem grupo",
    "items": [
      {
        "id": 1042,
        "active": true,
        "name": "Caminhão 07",
        "plate_number": "ABC1D23",
        "imei": "352094081234567",
        "device_model": "Suntech ST310U",
        "time": "2026-07-30 14:32:05",
        "engine_status": true,
        "engine_hours": 154020,
        "total_distance": 158234.7,
        "stop_duration": "5 min",
        "position": {
          "status": "online",
          "lat": -23.550520,
          "lng": -46.633308,
          "speed": 62,
          "course": 118,
          "altitude": 760,
          "time": "há 1 minuto",
          "timestamp": 1785509525
        },
        "driver": { "id": 12, "name": "João Silva" }
      }
    ]
  }
]

Campos mais usados

3. Cenário no Make, passo a passo

1. Trigger — agendamento: crie um cenário novo e configure a execução Schedule para cada 15 minutos (mínimo recomendado: 5 minutos).
2. Módulo HTTP → Make a request:
   • URL: https://plataforma.declatrack.com.br/api/get_devices
   • Método: GET
   • Query string: user_api_hash = sua chave · includes[] = position
   • Parse response: Yes (o Make interpreta o JSON automaticamente)
3. Iterator (grupos): itere sobre o array retornado (data).
4. Iterator (veículos): itere sobre items de cada grupo — cada ciclo agora é um veículo.
5. Módulo HTTP → POST no webhook Kondado: monte o corpo JSON mapeando os campos do veículo, por exemplo:

   {
     "veiculo_id": {{id}},
     "veiculo": "{{name}}",
     "placa": "{{plate_number}}",
     "ignicao": {{engine_status}},
     "odometro_km": {{total_distance}},
     "latitude": {{position.lat}},
     "longitude": {{position.lng}},
     "velocidade_kmh": {{position.speed}},
     "status_conexao": "{{position.status}}",
     "data_posicao": {{position.timestamp}}
   }

   Ajuste os nomes dos campos ao esquema já usado hoje na tabela declatrack_frota (mesmas colunas do TSV atual), para que o painel Power BI continue funcionando sem alterações de modelo.

4. Endpoints complementares (opcional)

Todos usam o mesmo user_api_hash. O formato de data/hora de get_history segue a configuração da conta de integração (a Declatrack a entregará configurada como AAAA-MM-DD e HH:MM, 24h).

5. Boas práticas e tratamento de erros

• Intervalo de consulta: 5 a 15 minutos é suficiente para dashboards de frota. Evite intervalos menores que 5 minutos.
• HTTP 401: chave inválida ou usuário suspenso — contate a Declatrack. Configure o Make para notificar por e-mail nesse caso (Error handler → Break + notificação).
• HTTP 429: excesso de requisições — aumente o intervalo do agendamento.
• Timeout: configure 40 s no módulo HTTP; frotas grandes podem levar alguns segundos.
• Idempotência: envie sempre o id do veículo e o position.timestamp ao Kondado, para que registros repetidos possam ser deduplicados no destino.

Checklist de ativação

1. Receber da Declatrack: URL base, usuário de integração e user_api_hash;
2. Testar o get_devices no navegador ou via curl;
3. Montar o cenário no Make conforme a seção 3 e executar manualmente uma vez (Run once);
4. Conferir a chegada dos dados no conector Kondado e na tabela declatrack_frota;
5. Ativar o agendamento e, após alguns dias de operação em paralelo, desativar a exportação manual do TSV.