Documentação da API do Pedágio Eletrônico
Esta documentação descreve as consultas públicas auxiliares de endereço e cadastro disponíveis no mesmo domínio do portal.
Consultas públicas disponíveis
GET /api/viacep?cep=... consulta um endereço pelo CEP. Informe oito dígitos; a pontuação é removida antes da validação.
GET /api/cnpj?cnpj=... consulta os dados cadastrais públicos de uma pessoa jurídica. Informe quatorze dígitos; a pontuação é removida antes da validação.
As respostas são JSON. Cada operação, parâmetro e campo de resposta está descrito no contrato OpenAPI da API do Pedágio Eletrônico. O contrato pode ser importado em ferramentas que aceitam OpenAPI 3.
Autenticação e limites do contrato
Essas duas consultas auxiliares aceitam requisições GET sem chave de API ou sessão. Elas dependem da disponibilidade dos serviços externos de consulta e não movimentam dinheiro.
Consultas de veículos, débitos, recargas e pagamentos não fazem parte desta API pública. Utilize os fluxos do portal; a área do cliente exige autenticação. Não existe credencial de integração financeira publicada nesta documentação.
Não há paginação ou operação de escrita nestas duas rotas. Este contrato não publica um limite numérico de requisições, SDK, CLI ou servidor MCP.
Erros e recuperação
Parâmetro ausente ou com quantidade de dígitos incorreta retorna HTTP 400. Cadastro ou endereço não encontrado retorna HTTP 404. Falhas na consulta externa podem retornar HTTP 500 ou o status de erro do serviço consultado.
Leia o campo error do JSON. Rotas de API inexistentes retornam HTTP 404 com code, message e resolution indicando onde encontrar o contrato. Corrija a URL ou o parâmetro antes de repetir a chamada.
Para navegar pelo conteúdo público sem JavaScript, solicite Accept: text/markdown na página inicial ou leia llms.txt. A resposta Markdown declara Vary: Accept, RSC e não permite armazenamento compartilhado.
Versão 1.0.0: publicação do contrato das consultas existentes e das orientações de acesso e recuperação de erros.