وثائق API

ادمج قدرات ABRP القوية في توجيه وتخطيط السيارات الكهربائية في منصتك. مجموعة API الشاملة لدينا تتيح تكاملًا سلسًا للتوجيه المدرك للمركبة، والتيليمترية، والروابط العميقة.

واجهات API والتكامل

اطّلع على مجموعة APIs لدينا لدمج توجيه EV والتيليمترية والروابط العميقة في منصتك.

Planning API

v2 - موصى به

v1 - قديم

توجيه مدرك للمركبة مع قدرات تخطيط شاملة للسيارات الكهربائية

توفر Planning API تخطيطًا متقدمًا للمسار يتطور مع التحسينات المستمرة في ABRP. تشمل الميزات نمذجة استهلاك الطاقة، وتحسين الشحن، ودمج حركة المرور في الوقت الفعلي، والتخطيط المراعي للطقس.

تستخدم API بنية REST مع مخرجات JSON وتدعم نقاط النهاية القديمة (v1) والحديثة (v2). تختلف تكاليف الإعداد والتسعير حسب احتياجات التكامل وحجم الاستخدام.

وثائق Planning v2 وثائق Planning v1 (قديم)

Telemetry API

بيانات المركبة في الوقت الفعلي للتتبع المباشر ونمذجة السيارات

تتيح Telemetry API نقل بيانات المركبة في الوقت الفعلي لتتبع الرحلة المباشر، وتحليل الاستهلاك، والتحسين المستمر لنماذج سياراتنا. يساعدنا ذلك على تحسين توقعات الطاقة ودقة التوجيه.

مفاتيح API مجانية متاحة للتكامل. يلزم رموز المستخدم لإرسال البيانات، ويمكن الحصول عليها عبر تدفق OAuth2 (موصى به) أو يدويًا للاختبار والتطوير.

وثائق Telemetry إدارة مفاتيح 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>"
}

Deep Links

تكامل قائم على URL لتخطيط مسار مُعد مسبقًا

أنشئ عناوين URL مخصّصة تفتح ABRP بمسارات واختيارات مركبات ومعلمات تخطيط مُعدّة مسبقًا. مثالي للتضمين في التطبيقات أو المواقع أو أنظمة الملاحة دون تكامل API.

تدعم الروابط العميقة مجموعة واسعة من معلمات URL بما في ذلك إحداثيات المنشأ والوجهة، ونقاط الطريق، وطرازات السيارات، ومستوى الشحن، وتفضيلات المستخدم. عنوان URL الأساسي: https://abetterrouteplanner.com

وثائق Deep Links