API Documentation

Isama ang makapangyarihang EV routing at planning ng ABRP sa platform mo. Sinusuportahan ng aming API suite ang seamless na vehicle-aware routing, telemetry, at deep linking.

APIs & Integration

I-access ang aming API suite para isama ang EV routing, telemetry, at deep linking sa platform mo.

Planning API

v2 - Inirerekomenda

v1 - Legacy

Vehicle-aware routing na may komprehensibong EV planning

Nag-aalok ang Planning API namin ng sopistikadong route planning na sumasabay sa patuloy na pagpapabuti ng ABRP. Kasama ang energy consumption modeling, charging optimization, real-time traffic integration, at weather-aware planning.

Gumagamit ang API ng REST architecture na may JSON output at sumusuporta sa legacy (v1) at modern (v2) endpoints. Nag-iiba ang setup cost at per-plan pricing ayon sa integration needs at usage volume mo.

v2 Planning Documentation v1 Planning Documentation (Legacy)

Telemetry API

Real-time na vehicle data para sa live tracking at car modeling

Pinapayagan ng Telemetry API ang real-time na pagpapadala ng vehicle data para sa live journey tracking, consumption analysis, at patuloy na pagpapabuti ng car models namin. Pinapaganda nito ang energy predictions at routing accuracy.

May libreng API keys para sa integration. Kailangan ang user tokens para sa data submission at makuha sa OAuth2 flow (inirerekomenda) o manual token retrieval para sa testing at development.

Telemetry Documentation Pamahalaan ang telemetry API keys mo

OAuth2 API

Secure na user authentication at authorization

Nagbibigay ang OAuth2 ng secure at maginhawang paraan para kilalanin at i-authenticate ang mga user sa Iternio. Para i-setup ang OAuth2, kailangan mo ng API key at dapat magbigay ng redirect URL at application name.

Authorization Flow

Ang unang call ay nagbabalik ng HTML page kung saan puwedeng mag-log in at aprubahan ng user ang app mo. Kung bubuksan sa default browser ng user, puwedeng naka-cache ang login para mapadali ang proseso.

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

Allowed scopes:

get_telemetry: Kunin ang pinakabagong telemetry ng user
set_telemetry: Mag-push ng bagong telemetry updates sa vehicle
get_plan: Kunin ang pinakabagong plan sa condensed form (contact us para sa detalye)
vehicle_history: Kunin ang historic drives at charging sessions (contact us para sa detalye)

Response sa redirect URI mo:

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

Token Retrieval

Kapag nakatanggap ka na ng authorization code, kunin ang token na puwedeng i-store at gamitin ulit kung kailangan.

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

Response format:

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

User Information

Pagkatapos makuha ang token, gamitin ang "me" endpoint para kunin ang user information:

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

Response format:

{
  "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

URL-based integration para sa pre-configured route planning

Gumawa ng custom URLs na naglulunsad ng ABRP na may pre-configured routes, vehicle selections, at planning parameters. Perpekto para i-embed sa apps, websites, o navigation systems nang walang API integration.

Sinusuportahan ng deep links ang malawak na hanay ng URL parameters kabilang ang origin/destination coordinates, waypoints, car models, state of charge, at user preferences. Base URL: https://abetterrouteplanner.com

Deep Links Documentation