Documentació de l'API
Integra a la teva plataforma l'encaminament potent i la planificació per a VE d'ABRP. El nostre conjunt d'APIs permet incorporar sense fricció l'encaminament adaptat al vehicle, la telemetria i els deep links.
APIs i integració
Accedeix al nostre conjunt d'APIs per integrar encaminament per a VE, telemetria i deep links a la teva plataforma.
Planning API
Encaminament conscient del vehicle amb planificació completa per a VE
La nostra Planning API ofereix planificació de rutes avançada que evoluciona amb les millores contínues d'ABRP. Inclou modelització del consum energètic, optimització de la càrrega, integració de trànsit en temps real i planificació conscient del temps meteorològic.
L'API fa servir una arquitectura REST amb sortida JSON i admet tant endpoints antics (v1) com moderns (v2). Els costos de configuració i el preu per pla varien segons les teves necessitats d'integració i el volum d'ús.
Telemetry API
Dades del vehicle en temps real per al seguiment i la modelització
La Telemetry API permet transmetre dades del vehicle en temps real per fer seguiment de viatges, analitzar el consum i millorar de manera contínua els nostres models de vehicle. D'aquesta manera afinem les prediccions energètiques i la precisió de l'encaminament.
Hi ha claus d'API gratuïtes per integrar. Calen tokens d'usuari per enviar dades; els pots obtenir amb el nostre flux OAuth2 (recomanat) o manualment per a proves i desenvolupament.
OAuth2 API
Autenticació i autorització segures d'usuari
OAuth2 proporciona una manera segura i còmode d'identificar i autenticar usuaris amb Iternio. Per configurar OAuth2 necessites una clau d'API i has d'indicar una URL de redirecció i un nom d'aplicació.
Flux d'autorització
La primera crida retorna una pàgina HTML on l'usuari pot iniciar sessió i aprovar la teva aplicació. Si s'obre en el navegador per defecte, l'inici de sessió es pot desar a la memòria cau per simplificar el procés.
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 telemetria més recent de l'usuariset_telemetry: Enviar noves actualitzacions de telemetria al vehicleget_plan: Obtenir l'últim pla en forma condensada (contacta'ns per als detalls)vehicle_history: Recuperar trajectes històrics i sessions de càrrega (contacta'ns per als detalls)
https://your_redirect_uri?state=<state_provided>&auth_code=<returned_auth_code>Obtenció del token
Quan reps un codi d'autorització, obtén el token, que podràs desar i tornar a fer servir quan calgui.
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ó de l'usuari
Després d'obtenir el token, fes servir el endpoint «me» per recuperar la informació de l'usuari:
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ó basada en URL per a planificació preconfigurada
Crea URL personalitzades que obren ABRP amb rutes, selecció de vehicle i paràmetres de planificació ja definits. Ideal per incrustar a apps, webs o sistemes de navegació sense integració per API.
Els deep links admeten un ventall ampli de paràmetres: coordenades d'origen i destinació, waypoints, models de cotxe, estat de càrrega i preferències de l'usuari. URL base: https://abetterrouteplanner.com