Pular para o conteúdo principal
Routal
Routal API · v2

O cérebro de roteirização do seu ERP.

Envie paradas a partir de SAP, Dynamics 365, Navision, Odoo — ou qualquer sistema que fale JSON. Receba rotas otimizadas, despache para os motoristas e reconcilie as entregas por webhooks.

Comece aqui

Da chave à primeira chamada em dois passos.

  1. 1

    Proteja sua API key

    Cada requisição é autenticada com uma API key privada. Gere e rotacione chaves na seção API Keys do dashboard do planner.

  2. 2

    Faça sua primeira requisição

    Passe a chave como query parameter private_key. Use os snippets à direita para verificar a conexão.

curl -G 'https://api.routal.com/v2/vehicles' \
  --data-urlencode 'private_key=xxxxxxxxxxxxx' \
  -H 'Content-Type: application/json'
Feito para integrar com IA

Seu assistente de IA já conhece a Routal.

Aponte o seu llms.txt para Cursor, Claude, Windsurf ou qualquer editor com IA. O modelo recebe o contexto completo da Routal — endpoints, pegadinhas, modelo mental — e gera código correto na primeira tentativa.

https://developers.routal.com/llms.txtVer
https://developers.routal.com/llms-full.txtVer
FAQ

O que todo dev pergunta primeiro.

Como faço a autenticação com a API da Routal?

Cada requisição é autenticada com uma API key privada passada como query parameter private_key. Gere e rotacione suas chaves na seção API Keys do dashboard do planner em planner.routal.com.

Qual é a base URL e a versão atual?

A base URL é https://api.routal.com e a versão atual é v2 — por exemplo, https://api.routal.com/v2/vehicles.

O que posso fazer com a API?

Criar e gerenciar planos, paradas, rotas e veículos por API, acompanhar entregas em tempo real e recuperar o comprovante de entrega. A Routal é uma plataforma de otimização de rotas e última milha.

A Routal suporta webhooks?

Sim. Assine os eventos do ciclo de vida da entrega para reconciliar entregas e comprovantes no seu próprio sistema conforme as rotas são executadas.

Existem limites de taxa (rate limits)?

Sim. As requisições são limitadas por credencial — atualmente 2.000 requisições por minuto por API key. Se exceder, você recebe uma resposta 429 Too Many Requests; aguarde e tente novamente com backoff exponencial.

Como integro a API com ferramentas de IA e agentes de código?

Aponte seu editor com IA (Cursor, Claude, Windsurf) para developers.routal.com/llms.txt ou llms-full.txt. O modelo recebe o contexto completo da Routal — endpoints, pegadinhas e modelo mental — e gera código correto na primeira tentativa.