Gobrax Developer Platform

API Playground
para Desenvolvedores

Explore, teste e integre as APIs da Gobrax em tempo real. Gere tokens, execute requisições e visualize respostas formatadas — tudo em um só lugar.

Resposta da API

"vehicleId": "VH-001",
"plate": "ABC-1234",
"odometer": 125430,
"unit": "km",
"ignition": true

200 OK 48ms · 312 B

🚛

APIs disponíveis

⚡

REST

Protocolo padrão

🔐

JWT

Bearer Token seguro

🌎

JSON

Respostas estruturadas

🔢

API Odometer

Consulte dados de hodômetro dos veículos da sua frota.

Testar agora →

📊

API Statistic

Estatísticas detalhadas de comportamento de condução.

Testar agora →

📍

API Position

Posição atual e histórico de localização dos veículos.

Testar agora →

🗺️

API Positions

Listagem de múltiplas posições com filtros avançados.

Testar agora →

👤

API Drivers

Dados completos dos motoristas cadastrados.

Testar agora →

🔗

API Link Drivers

Vincule motoristas a veículos da frota.

Testar agora →

👁️

API Overview

Visão geral consolidada da sua frota.

Testar agora →

🏎️

API Performance

Indicadores de performance e telemetria avançada.

Testar agora →

🚛

API Vehicles

Cadastro e informações técnicas dos veículos.

Testar agora →

Requisição

Nenhum token ativo. Gere um token primeiro.

API

Endpoint

GET

Parâmetros

Selecione uma API para ver os parâmetros.

Resposta

Selecione uma API

JSON

Tabela

cURL

📭

Envie uma requisição para ver a resposta

📋

Envie uma requisição para ver a tabela

💻

Selecione uma API para ver o comando cURL

200

Guia Rápido

🚀 Primeiros Passos 🔐 Autenticação ⚠️ Códigos de Erro 🚦 Rate Limits

APIs

🔢 Odometer 📊 Statistic 📍 Position 🗺️ Positions 👤 Drivers 🔗 Link Drivers 👁️ Overview 🏎️ Performance 🚛 Vehicles

Precisa de ajuda?

Fale com nosso time de integração.

Documentação

Referência da API Gobrax

Integre a plataforma de conectividade de frotas líder da América Latina. Acesse dados em tempo real de telemetria, posicionamento, performance e motoristas via REST API simples e bem documentada.

Base URL: https://api.gobrax.com.br Versão: v1 ● API Online

🚀 Primeiros Passos

Integre-se em menos de 5 minutos seguindo os passos abaixo.

Gere um Token

Use suas credenciais para obter um Bearer Token JWT.

Adicione no Header

Inclua o token em todas as requisições via Authorization: Bearer.

Faça Requisições

Consulte os endpoints e receba dados JSON estruturados em milissegundos.

cURL JavaScript Python

# 1. Gerar token
curl -X POST https://api.gobrax.com.br/api/v1/token \
  -H "Authorization: Basic $(echo -n 'login:senha' | base64)"

# 2. Usar o token
curl https://api.gobrax.com.br/api/v1/vehicles \
  -H "Authorization: Bearer SEU_TOKEN_AQUI"

🔐 Autenticação

Todas as requisições devem incluir um Bearer Token JWT no header Authorization. O token é gerado via credenciais Basic Auth e expira conforme configurado (1h a 72h).

POST /api/v1/token — Gerar token de acesso

Header	Tipo	Descrição
Authorization	string	`Basic base64(login:senha)` — Obrigatório

{

  "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1c2VyQGdvYnJheC5jb20ifQ...",

  "token_type": "Bearer",

  "expires_at": "2025-03-28T14:00:00Z",

  "expires_in": 86400

}

⚠️ Códigos de Erro

A API usa códigos HTTP padrão. Erros retornam um objeto JSON com campo error e message.

Código	Status	Descrição
200	OK	Requisição bem-sucedida.
400	Bad Request	Parâmetros inválidos ou ausentes.
401	Unauthorized	Token ausente, inválido ou expirado.
403	Forbidden	Sem permissão para este recurso.
404	Not Found	Recurso não encontrado.
429	Too Many Requests	Limite de requisições atingido. Aguarde e tente novamente.
500	Server Error	Erro interno. Contate o suporte.

// Exemplo de resposta de erro

{

  "error": "UNAUTHORIZED",

  "message": "Token expirado. Gere um novo token.",

  "code": 401

}

🚦 Rate Limits

As requisições são limitadas por plano. O header de resposta inclui informações sobre o uso atual.

100

req/min — Trial

1.000

req/min — Starter

∞

req/min — Enterprise

// Headers de resposta

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 847

X-RateLimit-Reset: 1711544400

Referência dos Endpoints

🔢

API Odometer

Leituras de hodômetro com controle de quilometragem e manutenção preventiva.

Postman →

GET /api/v1/odometer

Parâmetro	Tipo	Req.	Descrição
vehicleId	string	Sim	ID do veículo
startDate	date	Não	Data inicial YYYY-MM-DD
endDate	date	Não	Data final YYYY-MM-DD

{ "vehicleId": "VH-001", "plate": "ABC-1234", "odometer": 125430, "unit": "km", "timestamp": "2025-03-27T10:30:00Z" }

📊

API Statistic

Estatísticas de comportamento de condução, consumo e eventos de segurança.

Postman →

GET/api/v1/statistics

Parâmetro	Tipo	Req.	Descrição
vehicleId	string	Sim	ID do veículo
startDate	date	Sim	Data inicial YYYY-MM-DD
endDate	date	Sim	Data final YYYY-MM-DD
groupBy	string	Não	`day` \| `week` \| `month`

{ "distanceKm": 3420.5, "fuelLiters": 340.2, "avgSpeedKmh": 68.4, "harshBraking": 12, "overspeedEvents": 3 }

📍

API Position

Posição GPS em tempo real: coordenadas, velocidade, heading e status de ignição do veículo.

Postman →

GET /api/v1/position/{vehicleId}

Parâmetro	Tipo	Req.	Descrição
vehicleId	string	Sim	ID do veículo (path param)

Resposta de exemplo:

{

  "vehicleId": "VH-001",

  "plate": "ABC-1234",

  "lat": -23.550520,

  "lng": -46.633308,

  "speed": 72,

  "heading": 135,

  "ignition": true,

  "address": "Av. Paulista, 1578 - São Paulo",

  "timestamp": "2025-03-27T10:30:00Z"

}

Casos de uso

Mapa ao vivo com atualização a cada 30s via polling
Alertas de entrada/saída de geocercas em tempo real
Verificação de status de ignição para controle de jornada

🗺️

API Positions

Histórico de posições de múltiplos veículos com paginação e filtros por período.

Postman →

GET /api/v1/positions

Parâmetro	Tipo	Req.	Descrição
startDate	date	Sim	Data inicial YYYY-MM-DD
endDate	date	Sim	Data final YYYY-MM-DD
vehicleId	string	Não	Filtrar por veículo específico
page	integer	Não	Página (default: 1)
limit	integer	Não	Registros por página (max: 500)

{ "total": 1432, "page": 1, "limit": 100, "data": [{ "vehicleId": "VH-001", "lat": -23.55, "lng": -46.63, "speed": 68, "timestamp": "2025-03-27T08:12:00Z" }] }
                

Dica de performance

Limite janelas de consulta a no máximo 7 dias por requisição. Para períodos maiores, pagine em lotes e processe de forma assíncrona para não bloquear sua interface.

👤

API Drivers

Listagem completa de motoristas com score de desempenho, status ativo e dados cadastrais.

Postman →

GET /api/v1/drivers

Parâmetro	Tipo	Req.	Descrição
status	string	Não	`active` \| `inactive`
search	string	Não	Busca por nome ou CPF
page	integer	Não	Paginação (default: 1)

{ "id": "DR-042", "name": "Carlos Silva", "cpf": "***.***.***-12", "cnh": "E", "score": 87.4, "status": "active", "linkedVehicle": "VH-001" }
                

🔗

API Link Drivers

Vincula e desvincula motoristas a veículos com rastreabilidade completa de sessão.

Postman →

POST /api/v1/drivers/link Vincular motorista a veículo

Campo (body)	Tipo	Req.	Descrição
vehicleId	string	Sim	ID do veículo a ser vinculado
driverId	string	Sim	ID do motorista
startTime	datetime	Não	Início da sessão (ISO 8601). Default: agora
source	string	Não	`manual` \| `ibutton` \| `rfid` \| `app`

Sucesso — 200

{ "sessionId": "SES-9f3a", "vehicleId": "VH-001", "driverId": "DR-042", "linkedAt": "2025-03-27T07:00:00Z", "source": "ibutton" }

Conflito — 409

{ "error": "VEHICLE_ALREADY_LINKED", "currentDriver": "DR-019", "since": "2025-03-27T06:00:00Z" }

DELETE /api/v1/drivers/link/{vehicleId} Desvincular motorista do veículo

Encerra a sessão ativa do motorista no veículo, registrando endTime e calculando a duração total da viagem. Retorna 204 No Content em caso de sucesso.

Boas Práticas do Mercado

Padrões adotados pelas principais rastreadores do mercado brasileiro — Sascar, TrucksControl, AutoTrack, Onixsat e Cobli.

🔑 Identificação do Motorista — iButton & RFID

Sascar e TrucksControl utilizam iButton (Dallas 1-Wire, protocolo DS1990A) embarcado no rastreador. O código de 8 bytes único do chaveiro é lido ao contato físico na entrada do veículo, gerando um evento de identificação que dispara automaticamente o vínculo via API.

AutoTrack e Onixsat suportam também leitores RFID 125 kHz (EM4100) e 13.56 MHz (MIFARE), permitindo identificação sem contato físico — mais prático para frotas com alta rotatividade de motoristas.

// Envio automático via webhook do hardware

POST /api/v1/drivers/link

{

  "vehicleId": "VH-001",

  "driverId": "DR-042",  // resolvido pelo iButton ID

  "source": "ibutton",

  "deviceToken": "0100000A3F2B1C8D"

}

Recomendação: mantenha um mapa local ibutton_id → driverId no seu backend para resolver o vínculo antes de chamar a API. Assim você evita round-trips desnecessários.

⏱️ Ciclo de Vida da Sessão

O padrão adotado por Cobli e TrucksControl define três eventos explícitos de sessão:

🟢

SESSION_START

Motorista identificado + ignição ligada

🟡

SESSION_IDLE

Ignição desligada, motorista ainda vinculado

🔴

SESSION_END

Desvínculo explícito ou timeout por inatividade

Timeout recomendado: Sascar usa 8h de inatividade como limite padrão para encerramento automático de sessão. Implemente um job que chame DELETE se não houver posição nova após esse período.

⚠️ Resolução de Conflitos

Conflitos ocorrem quando dois motoristas tentam vincular ao mesmo veículo simultaneamente, ou quando a sessão anterior não foi encerrada corretamente. AutoTrack adota a seguinte estratégia:

// Lógica recomendada ao receber 409

if (error === 'VEHICLE_ALREADY_LINKED') {

  // 1. Encerra sessão anterior automaticamente

  await DELETE(`/api/v1/drivers/link/${vehicleId}`)

  // 2. Aguarda propagação (50ms)

  await sleep(50)

  // 3. Cria novo vínculo

  await POST('/api/v1/drivers/link', newLink)

}

Atenção: nunca force um novo vínculo sem desencerrar o anterior. A sessão orfã continuará acumulando quilometragem e distorcerá o score do motorista anterior.

📋 Trilha de Auditoria

Sascar e Onixsat exigem rastreabilidade total de cada vinculação para fins de compliance trabalhista (jornada de motorista — Lei 13.103). Recomendamos persistir no seu banco:

Campo	Tipo	Descrição
sessionId	UUID	Retornado na resposta do POST
source	string	ibutton / rfid / manual / app
operatorId	string	Usuário da API que realizou a ação
durationMin	integer	Duração calculada ao encerrar sessão

📱 Identificação via App (Cobli, TrucksControl)

Plataformas modernas como Cobli permitem que o próprio motorista realize o check-in pelo aplicativo mobile, usando login com CPF + senha ou biometria. O app chama a API de vínculo com source: "app" e o token JWT do motorista no header.

# O motorista faz login no app e vincula o próprio veículo

curl -X POST /api/v1/drivers/link \

  -H "Authorization: Bearer <driver-jwt-token>" \

  -d '{"vehicleId":"VH-001","source":"app"}'

Vantagem: elimina hardware adicional (iButton/RFID), reduz custo por veículo e dá autonomia ao motorista — especialmente útil para frotas terceirizadas ou agregadas.

👁️

API Overview

Dashboard consolidado da frota: veículos ativos, alertas críticos, distância acumulada e score médio.

Postman →

GET /api/v1/overview

Nenhum parâmetro obrigatório. Retorna snapshot atual da frota inteira vinculada ao token.

{

  "fleet": {

    "total": 142,

    "active": 98,

    "idle": 31,

    "offline": 13

  },

  "alerts": { "critical": 3, "warning": 14 },

  "totalDistanceKmToday": 12430.8,

  "avgFleetScore": 81.2,

  "updatedAt": "2025-03-27T10:45:00Z"

}

Uso recomendado

Ideal para telas de dashboard. Faça polling a cada 60s para manter KPIs atualizados sem sobrecarregar a API.

Cache sugerido

Dados têm granularidade de 30s no servidor. Cache local de 30-60s no cliente não degrada a experiência.

🏎️

API Performance

Score de condução por motorista/veículo, ranking comparativo, consumo médio e eventos críticos por período.

Postman →

GET /api/v1/performance

Parâmetro	Tipo	Req.	Descrição
startDate	date	Sim	Data inicial YYYY-MM-DD
endDate	date	Sim	Data final YYYY-MM-DD
driverId	string	Não	Filtrar por motorista específico
vehicleId	string	Não	Filtrar por veículo

{

  "driverId": "DR-042",

  "score": 87.4,

  "rank": 3,

  "totalDrivers": 48,

  "fuelPer100km": 28.6,

  "events": { "harshBraking": 4, "speeding": 1, "sharpTurn": 2 }

}

Composição do Score

O score (0–100) pondera: frenagem brusca (30%), excesso de velocidade (25%), curvas agressivas (20%), aceleração brusca (15%) e uso do cinto/equipamentos (10%).

🚛

API Vehicles

Cadastro completo da frota: placa, modelo, chassi, status do rastreador, grupo e dados de manutenção.

Postman →

GET /api/v1/vehicles

Parâmetro	Tipo	Req.	Descrição
status	string	Não	`active` \| `inactive` \| `maintenance`
group	string	Não	Filtrar por grupo/filial
search	string	Não	Busca por placa ou chassi

{

  "id": "VH-001",

  "plate": "ABC-1234",

  "model": "Scania R450",

  "year": 2022,

  "trackerStatus": "online",

  "group": "Filial SP",

  "currentDriver": "DR-042",

  "nextMaintenance": { "type": "oil_change", "atKm": 130000 }

}

Planos & Preços

Conecte sua frota.
Escale com confiança.

Comece grátis, cresça sem limites. Escolha o plano ideal para o tamanho e necessidade da sua operação.

Trial

Grátis

Para testar a integração

Inclui

✓ 100 requisições/mês
✓ 3 APIs liberadas
✓ Token de 1 hora
✓ Suporte via docs
— Dados em produção
— SLA garantido
— Webhooks

⭐ Mais Popular

Starter

R$ 490 /mês

Para operações em crescimento

Tudo do Trial +

✓ 1.000 req/min
✓ Todas as 9 APIs
✓ Token até 72 horas
✓ Dados em produção
✓ Suporte por e-mail
✓ Histórico 12 meses
— Webhooks em tempo real

Enterprise

Sob consulta

Para grandes frotas e integradores

Tudo do Starter +

✓ Requisições ilimitadas
✓ Webhooks em tempo real
✓ SLA 99.9% garantido
✓ IP dedicado
✓ Suporte 24/7 prioritário
✓ Histórico completo
✓ Onboarding dedicado

Perguntas frequentes

Preciso de cartão de crédito para o Trial?

Não. O Trial é gratuito e não requer cadastro de pagamento. Basta gerar um token e começar a explorar as APIs.

Posso mudar de plano a qualquer momento?

Sim. O upgrade é imediato e o billing é proporcional ao período restante.

O que acontece se eu ultrapassar o limite do Trial?

As requisições retornam erro 429. Basta fazer upgrade para o Starter para continuar sem interrupções.

Vocês têm contrato de SLA?

O plano Enterprise inclui contrato de SLA com 99.9% de uptime garantido e compensação em créditos.

Gobrax API

Pronto para integrar sua frota?

Fale com nosso time de especialistas e descubra como a API Gobrax pode transformar sua operação.

API Playgroundpara Desenvolvedores

Referência da API Gobrax

🚀 Primeiros Passos

🔐 Autenticação

⚠️ Códigos de Erro

🚦 Rate Limits

API Odometer

API Statistic

API Position

API Positions

API Drivers

API Link Drivers

Boas Práticas do Mercado

API Overview

API Performance

API Vehicles

Conecte sua frota.Escale com confiança.

Perguntas frequentes

Pronto para integrar sua frota?

💳 Contratar Plano

🔐 Gerar Token de Acesso

API Playground
para Desenvolvedores

Conecte sua frota.
Escale com confiança.