Documentación da API

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

APIs e integración

Acede à nosa 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: modelación de consumo energético, otimización de carregamentos, integración de tráfico 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 configuración e preços por plano dependem das necessidades de integración e do volume.

Documentación Planning v2 Documentación Planning v1 (Legacy)

Telemetry API

Dados do veículo em tempo real para seguimento e modelación

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

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

Documentación Telemetry Gerir as tuas chaves da Telemetry API

OAuth2 API

Autenticación e autorización de usuarios seguras

O OAuth2 oferece uma forma segura e simples de identificar e autenticar usuarios na Iternio. Para configurar OAuth2 precisas de uma chave API e de um URL de redirección e do nome da aplicación.

Fluxo de autorización

O primeiro pedido devolve uma páxina HTML onde os usuarios 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 usuario
set_telemetry: Enviar novas actualizacións de telemetria para o veículo
get_plan: Obter o último plano em forma condensada (contacta connosco para detalhes)
vehicle_history: Ler trajetos e sessões de carregamento históricas (contacta connosco para detalhes)

Resposta no teu URI de redirección:

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

Obtención do token

Depois de receberes o código de autorización, obtés 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>"
}

Información do usuario

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

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

Integración por URL para rotas xa 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 integración 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

Documentación de Deep Links