Documentação da API

Integra na tua plataforma o poderoso roteamento e planeamento EV do ABRP. A nossa suíte de APIs permite uma integração simples com encaminhamento compatível com o veículo, telemetria e deep links.

APIs e integração

Acede à nossa suíte de APIs para integrar rotas EV, telemetria e deep links na tua plataforma.

Planning API

v2 - Recomendada

v1 - Legacy

Roteamento compatível com o veículo e planeamento EV completo

A Planning API oferece planeamento avançado de rotas que evolui com as melhorias contínuas do ABRP: modelação de consumo energético, otimização de carregamentos, integração de trânsito em tempo real e planeamento que tem em conta a meteorologia.

A API usa arquitetura REST com resultado em JSON e suporta pontos finais legacy (v1) e modernos (v2). Custos de configuração e preços por plano dependem das necessidades de integração e do volume.

Documentação Planning v2 Documentação Planning v1 (Legacy)

Telemetry API

Dados do veículo em tempo real para seguimento e modelação

A Telemetry API permite transmitir dados do veículo em tempo real para seguimento de viagens, análise de consumo e evolução contínua dos nossos modelos. Assim apuramos melhor as previsões energéticas e a precisão das rotas.

Há chaves API gratuitas. Para enviar dados precisas de tokens de utilizador, obtidos via fluxo OAuth2 (recomendado) ou manualmente para testes.

Documentação Telemetry Gerir as tuas chaves da Telemetry API

OAuth2 API

Autenticação e autorização de utilizadores seguras

O OAuth2 oferece uma forma segura e simples de identificar e autenticar utilizadores na Iternio. Para configurar OAuth2 precisas de uma chave API e de um URL de redirecionamento e do nome da aplicação.

Fluxo de autorização

O primeiro pedido devolve uma página HTML onde os utilizadores iniciam sessão e aprovam a tua app. Se abrir no navegador predefinido, o login pode ficar em cache para simplificar.

https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>

Âmbitos permitidos:

get_telemetry: Ler a telemetria mais recente do utilizador
set_telemetry: Enviar novas atualizações de telemetria para o veículo
get_plan: Obter o último plano em forma condensada (contacta-nos para detalhes)
vehicle_history: Ler trajetos e sessões de carregamento históricas (contacta-nos para detalhes)

Resposta no teu URI de redirecionamento:

https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>

Obtenção do token

Depois de receberes o código de autorização, obtém o token que podes guardar e reutilizar.

https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>

Formato da resposta:

{
  "access_token": "<the created token>",
  "token_type": "bearer",
  "state": "<your supplied state>"
}

Informação do utilizador

Depois de obteres o token, usa o endpoint "me" para obter dados do utilizador:

https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>

Formato da resposta:

{
  "user_id": <the numeric ID of the user>,
  "full_name": "<Full name of the user>",
  "email": "<Email of user>",
  "vehicle_id": <The numeric ID of the vehicle, if part of the scope>,
  "vehicle_name": "<The vehicle name>",
  "vehicle_typecode": "<The vehicle typecode>"
}

Deep Links

Integração por URL para rotas já configuradas

Cria URLs personalizados que abrem o ABRP com rotas pré-configuradas, veículos e parâmetros de planeamento. Ideal para incluir em apps, sites ou sistemas sem integração direta pela API.

Os deep links aceitam muitos parâmetros URL, incluindo coordenadas de origem e destino, pontos intermediários, modelos, estado de carga e preferências. URL base: https://abetterrouteplanner.com

Documentação de Deep Links