Introdução
A Toll API é uma API Restful capaz de retornar dados e os valores dos pedágios presentes na rota. Com a Toll API você pode:
Toll
Posts
Cobertura do serviço e particularidades
A Toll API possui cobertura para o cálculo de pedágios nos seguintes países: Argentina, Brasil, Chile, Colômbia e México. A operação e o método de tarifação variam conforme o país [...]
Construindo requisições para a Toll API
Antes de começar a usar a API, será necessário obter o token de autenticação. Os seguintes headers serão necessários, onde a palavra token deverá ser substiuída pelo token obtido n [...]
Lista de parâmetros
Parâmetros obrigatórios Os seguintes parâmetros são necessários: Formatos de coordenadas aceitos Os seguintes formatos são suportados como entrada das coordenadas no parâmetro poin [...]
Estrutura da resposta – Endpoint independente
Nesse exemplo, temos uma rota simples que passa pelo pedágio de Itaquaquecetuba. Iremos utilizar o endpoint independente para obter o cálculo dos pedágios. Requisição O parâmetro&n [...]
Estrutura da resposta – Trip API
Nesse exemplo usaremos a integração com a Trip API em um rota entre Campo Grande-MS e Parati-RJ com os valores de pedágio para um caminhão de dois eixos. Requisição Na requisição p [...]
Exemplo – Pedágios com desconto por meio de pagamento automático
Algumas praças de pedágio oferecem uma porcentagem de desconto para usuários que utilizam meios de pagamento automático, conhecidos como TAG ou TelePeaje. No Brasil essa porc [...]
Exemplo – Pedágios com tarifas por faixa de horário
Algumas praças de pedágio, principalmente na Argentina e no Chile, possuem valores condicionantes que variam conforme o dia, horário ou época do ano em que a rota está sendo realiz [...]
Exemplo – Pedágios com tarifas dependendo da origem e destino (México)
Este exemplo é específico para rotas traçadas no México, onde algumas autopistas possuem o sistema de cobrança fechado. Nessas autopistas, o valor em cada pedágio irá variar de aco [...]
Exemplo – Rota com trechos usando veículo com eixos levantados
O exemplo a seguir considera uma rota entre as cidades de Guaxupé -MG a São Carlos – SP, com duas paradas intermediárias nas cidades de Casa Branca – SP e Porto Ferreir [...]
Status Codes – Toll
Abaixo a tabela com os status codes para cada endpoint disponível na Toll API: Código Método Endpoint Descrição 200 POST https://api.maplink.global/toll/v1/calculations OK (cálculo [...]
Error messages – Toll
A tabela a seguir mostra todas as mensagens de erro que podem ser retornadas pela API no body da resposta: Código de erro Mensagem Descrição VALIDATION_FAILED ou VALIDATION_ERROR { [...]
