תיעוד API

שלבו את יכולות הניתוב והתכנון העוצמתיות של ABRP לרכב חשמלי בתוך הפלטפורמה שלכם. חבילת ה־API המקיפה שלנו מאפשרת שילוב חלק של ניתוב מודע־רכב, טלמטריה וקישורים עמוקים.

API ושילובים

גישה לחבילת ה־API שלנו לשילוב ניתוב לרכב חשמלי, טלמטריה וקישורים עמוקים בפלטפורמה שלכם.

Planning API

v2 - מומלץ

v1 - legacy

ניתוב מודע־רכב עם יכולות תכנון מקיפות לרכב חשמלי

ה־Planning API שלנו מספק תכנון מסלול מתקדם שמתפתח יחד עם השיפורים השוטפים של ABRP. התכונות כוללות מידול צריכת אנרגיה, אופטימיזציית טעינה, שילוב תנועה בזמן אמת ותכנון מודע־מזג־אוויר.

ה־API משתמש בארכיטקטורת REST עם פלט JSON ותומך בנקודות קצה ישנות (v1) ומודרניות (v2). עלויות ההקמה ומחיר לכל תוכנית משתנים לפי צרכי השילוב והיקף השימוש שלכם.

תיעוד Planning v2 תיעוד Planning v1 (legacy)

Telemetry API

נתוני רכב בזמן אמת למעקב חי ולמידול רכב

ה־Telemetry API מאפשר העברת נתוני רכב בזמן אמת לצורך מעקב נסיעה חי, ניתוח צריכה ושיפור שוטף של מודלי הרכב שלנו. זה עוזר לנו לחדד את חיזויי האנרגיה ואת דיוק הניתוב.

מפתחות API חינמיים זמינים לשילוב. נדרשים אסימוני משתמש לשליחת נתונים, שניתן להשיגם דרך זרימת ה־OAuth2 שלנו (מומלץ) או באחזור ידני של אסימון לבדיקות ופיתוח.

תיעוד Telemetry ניהול מפתחות ה־API שלכם לטלמטריה

OAuth2 API

אימות והרשאות משתמש מאובטחים

OAuth2 מספק דרך מאובטחת ונוחה לזיהוי ולאימות משתמשים מול Iternio. כדי להגדיר OAuth2 תזדקקו למפתח API ותידרשו לספק כתובת redirect ושם אפליקציה.

זרימת ההרשאה

הקריאה הראשונה מחזירה דף HTML שבו המשתמשים יכולים להתחבר ולאשר את האפליקציה שלכם. אם הוא נפתח בדפדפן ברירת המחדל של המשתמש, ייתכן שההתחברות שלו תהיה במטמון כדי לפשט את התהליך.

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

הרשאות מותרות:

get_telemetry: אחזור הטלמטריה האחרונה של המשתמש
set_telemetry: דחיפת עדכוני טלמטריה חדשים לרכב
get_plan: קבלת התוכנית האחרונה בצורה מקוצרת (פנו אלינו לפרטים)
vehicle_history: אחזור היסטוריית נסיעות וטעינות (פנו אלינו לפרטים)

תשובה בכתובת ה־redirect שלכם:

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

אחזור אסימון

לאחר שתקבלו קוד הרשאה, אחזרו את האסימון, שאותו ניתן לשמור ולהשתמש בו שוב לפי הצורך.

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

פרטי משתמש

לאחר קבלת האסימון, השתמשו בנקודת הקצה "me" כדי לאחזר את פרטי המשתמש:

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

קישורים עמוקים

שילוב מבוסס־URL לתכנון מסלול מוגדר מראש

צרו כתובות URL מותאמות אישית שמפעילות את ABRP עם מסלולים, בחירות רכב ופרמטרי תכנון מוגדרים מראש. מושלם להטמעה באפליקציות, באתרים או במערכות ניווט ללא שילוב API.

קישורים עמוקים תומכים במגוון רחב של פרמטרי URL כולל קואורדינטות מוצא ויעד, נקודות עצירה, דגמי רכב, אחוזי סוללה והעדפות משתמש. כתובת בסיס: https://abetterrouteplanner.com

תיעוד קישורים עמוקים