Documentación de la API
Integra en tu plataforma el potente enrutado y la planificación para VE de ABRP. Nuestra suite de APIs permite incorporar de forma fluida el enrutado consciente del vehículo, la telemetría y los deep links.
APIs e integración
Accede a nuestra suite de APIs para integrar enrutado para VE, telemetría y deep links en tu plataforma.
Planning API
Enrutado consciente del vehículo con planificación completa para VE
Nuestra Planning API ofrece planificación de rutas avanzada que evoluciona con las mejoras continuas de ABRP. Incluye modelado del consumo energético, optimización de carga, integración de tráfico en tiempo real y planificación atenta al clima.
La API usa arquitectura REST con salida JSON y admite endpoints heredados (v1) y modernos (v2). Los costes de configuración y el precio por plan varían según tus necesidades de integración y el volumen de uso.
Telemetry API
Datos del vehículo en tiempo real para seguimiento y modelado
La Telemetry API permite transmitir datos del vehículo en tiempo real para el seguimiento de viajes, el análisis del consumo y la mejora continua de nuestros modelos de coche. Así refinamos las predicciones de energía y la precisión del enrutado.
Hay claves de API gratuitas para integrar. Se necesitan tokens de usuario para enviar datos; puedes obtenerlos con nuestro flujo OAuth2 (recomendado) o manualmente para pruebas y desarrollo.
OAuth2 API
Autenticación y autorización seguras de usuario
OAuth2 ofrece una forma segura y cómoda de identificar y autenticar a los usuarios con Iternio. Para configurarlo necesitas una clave de API y debes indicar una URL de redirección y un nombre de aplicación.
Flujo de autorización
La primera llamada devuelve una página HTML donde el usuario puede iniciar sesión y aprobar tu aplicación. Si se abre en el navegador predeterminado, el inicio de sesión puede quedar en caché para simplificar el proceso.
https://abetterrouteplanner.com/oauth/auth?client_id=<your_client_id>&scope=<requested_scope>&response_type=code&redirect_uri=<your_redirect_uri>get_telemetry: Recuperar la telemetría más reciente del usuarioset_telemetry: Enviar nuevas actualizaciones de telemetría al vehículoget_plan: Obtener el último plan en forma condensada (contáctanos para detalles)vehicle_history: Recuperar trayectos históricos y sesiones de carga (contáctanos para detalles)
https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>Obtención del token
Cuando recibas un código de autorización, obtén el token, que podrás almacenar y reutilizar cuando lo necesites.
https://api.iternio.com/1/oauth/token?client_id=<your_client_id>&client_secret=<your_api_key>&code=<auth_code>{
"access_token": "<the created token>",
"token_type": "bearer",
"state": "<your supplied state>"
}Información del usuario
Tras obtener el token, usa el endpoint «me» para recuperar la información del usuario:
https://api.iternio.com/1/oauth/me?access_token=<the user token>&api_key=<your api key>{
"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 basada en URL para planificación preconfigurada
Crea URLs personalizadas que abren ABRP con rutas, selección de vehículo y parámetros de planificación ya configurados. Ideal para incrustar en apps, webs o sistemas de navegación sin integración por API.
Los deep links admiten un amplio rango de parámetros: coordenadas de origen y destino, waypoints, modelos de coche, estado de carga y preferencias de usuario. URL base: https://abetterrouteplanner.com