PRORRAC Docs - Documentacao Tecnica

Integracao via API

Conecte seu sistema ao PRORRAC e acesse os dados de rastreamento

🔐 Autenticacao

POST /api/session

Faca login com seu usuario e senha para obter acesso aos dados. Apos autenticar, voce pode consultar veiculos, posicoes e relatorios.

📊 Relatorios

GET /api/reports/route

GET /api/reports/events

GET /api/reports/trips

GET /api/reports/stops

GET /api/reports/summary

Gere mais de 16 tipos de relatorios: jornadas, analise de viagens, velocidades, eventos, rotas, paradas, resumos e muito mais atraves do cruzamento de dados.

📍 Localizacao em Tempo Real

GET /api/positions

Consulte a posicao atual dos veiculos com coordenadas, velocidade, direcao e status da ignicao. Atualizacao em tempo real.

🚗 Veiculos

GET /api/devices

Liste todos os veiculos da sua conta com informacoes de placa, modelo, status de conexao e ultima comunicacao.

🔔 Eventos

GET /api/events/{id}

Consulte eventos e alertas do veiculo: excesso de velocidade, entrada/saida de cercas, ignicao ligada/desligada, panico, bateria baixa e outros.

📡 WebSocket (Tempo Real)

WS /api/socket

Conexao em tempo real para atualizar posicoes no mapa, lista de veiculos e receber alertas instantaneos. Ideal para paineis de monitoramento.

16+ Possibilidades de Relatorios

Combine os endpoints de rotas, eventos, viagens e paradas para criar diversos tipos de analises:

Jornada de Trabalho Horario de inicio e fim das atividades

Analise de Velocidade Velocidade media, maxima e excessos

Tempo Parado Quanto tempo o veiculo ficou parado

Quilometragem Distancia percorrida por periodo

Historico de Rotas Trajeto completo com pontos no mapa

Eventos do Veiculo Ignicao, alertas, cercas virtuais

Viagens Realizadas Origem, destino e duracao

Consumo Estimado Calculo baseado na quilometragem

Dicas de Uso da API

1. Sempre autentique primeiro

Antes de qualquer consulta, faca POST em /api/session com email e senha. O cookie de sessao sera usado nas proximas requisicoes.

2. Use filtros de data

Nos relatorios, sempre informe os parametros "from" e "to" no formato ISO 8601 (ex: 2024-01-01T00:00:00Z) para limitar o periodo.

3. Consulte posicoes em tempo real

O endpoint /api/positions retorna a ultima posicao de cada veiculo. Para historico, use /api/reports/route.

4. Formatos de exportacao

Os relatorios podem ser exportados em JSON, Excel (XLSX) ou PDF alterando o header "Accept" da requisicao.

5. Eventos em tempo real via WebSocket

Conecte ao /api/socket para receber alertas instantaneos. Ideal para paineis de monitoramento e aplicativos que precisam de notificacoes imediatas.

Exemplos de Uso

1. Autenticar na API

POST /api/session Content-Type: application/x-www-form-urlencoded email=usuario@email.com&password=suasenha

2. Listar todos os veiculos

GET /api/devices // Resposta: [ { "id": 1, "name": "ABC-1234", "status": "online", "lastUpdate": "2024-01-15T10:30:00Z" } ]

3. Obter posicao em tempo real

GET /api/positions?deviceId=1 // Resposta: [ { "latitude": -9.6658, "longitude": -35.7350, "speed": 45, "course": 180, "attributes": { "ignition": true } } ]

4. Gerar relatorio de viagens

GET /api/reports/trips?deviceId=1&from=2024-01-01T00:00:00Z&to=2024-01-31T23:59:59Z // Resposta: Lista de viagens com origem, destino, duracao e distancia

5. WebSocket - Posicoes e Eventos em Tempo Real

// JavaScript - Conectar ao WebSocket const socket = new WebSocket('wss://seu-servidor/api/socket'); socket.onmessage = function(event) { const data = JSON.parse(event.data); // Atualizar posicoes no mapa if (data.positions) { data.positions.forEach(pos => { atualizarMapa(pos.deviceId, pos.latitude, pos.longitude); }); } // Exibir alertas/eventos if (data.events) { data.events.forEach(e => exibirAlerta(e.type, e.deviceId)); } };

Area Restrita

Acesso exclusivo para parceiros e desenvolvedores com documentacao tecnica completa

Entrar