API de portagensintegraçãoRESTdesenvolvedores

API de portagens: integre o cálculo de portagens no seu software

O que é uma API de portagens e como chamar os endpoints de portagens e custos da Tolls Calculator com autenticação Bearer, exemplos e boas práticas.

Por Jorge Parada, CTO de Cargoffer

API de portagens: integre o cálculo no seu software

Resposta direta: uma API de portagens recebe uma rota (polyline ou waypoints), um perfil de veículo e um método de pagamento, e devolve o custo por segmentos. A Tolls Calculator documenta duas portas: POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate (só portagens) e POST https://api.cargoffer.com/costs/calculate (portagem + combustível + condutor).

Autenticação

Ambos usam Authorization: Bearer <API_KEY>; a chave é emitida pela equipa de produto e nunca deve ir em código de frontend.

Endpoint de portagens

Payload: polyline, vehicle_class (CLASS_1 a CLASS_4), payment_method (TELEPASS, VIA_T, CASH, CARD). Resposta: total em EUR e array toll_sections (valores ilustrativos). Referência completa na especificação.

Práticas de integração

Faça cache por geometria + data, guarde o timestamp da consulta para auditorias, valide o perfil antes de chamar e trate resultados como estimativas.

Todos os montantes são ilustrativos; o resultado real vem de consultas em tempo real.

Perguntas frequentes

Como se autentica a API de portagens?
Token Bearer no header Authorization; a chave fica no backend e é emitida pela equipa de produto.
O que devolve a resposta?
Total e detalhe por segmento (infraestrutura, custo, distância) para auditoria e comparação de rotas.
Posso usar sem ter a rota calculada?
Use o endpoint de custos com waypoints; o de portagens exige uma polyline.

Recursos relacionados

MCP de portagens: ligue agentes IA à API da Tolls CalculatorCalculadora de portagens: como calcular o custo de uma rota

Pronto para calcular portagens com dados em tempo real?

Experimentar a calculadoraVer planos e API