الوصول إلى API

ادمج بيانات EV Manual في أجهزة التشخيص أو أنظمة إدارة الورش أو منصات التجارة الإلكترونية. خدمات الشركاء متوفرة بثلاثة أشكال — اختر ما يناسب منتجك:

مجالات البيانات

يكشف API أربعة مجالات بيانات — فك ترميز VIN، والبطاقات التقنية، وأدلة الإصلاح، والمخططات مع البحث عن رموز DTC — ويتضمن كل استجابة نفس بيانات مستوى المطابقة التي يعرضها واجهة الويب. ونتيجة لذلك يمكن للمكامل عرض معلومات الثقة للمستخدمين النهائيين دون منطق إضافي.

المصادقة والفوترة

تُصادَق كل طلب بزوج مفاتيح API وتوقيع HMAC-SHA256 يغطي الختم الزمني ونص الطلب، مما يمنع هجمات الإعادة والاستخدام غير المصرح. والدفع حسب الاستخدام: تُقاس الاستدعاءات وتُخصم من رصيد الرموز المميزة لديك، وتخفض شرائح الحجم السعر الوحدوي تلقائياً مع نمو الاستخدام.

• يحصل كل شريك على زوج مفاتيح API؛ وتُوقَّع الطلبات بخوارزمية HMAC-SHA256 مع ختم زمني.
• الدفع حسب الاستخدام: تُقاس الاستدعاءات وتُخصم من رصيد الرموز المميزة لديك؛ وتخفض شرائح الحجم السعر الوحدوي.
• تتوسع الحدود مع شريحتك، فلا تتوقف أداة تشخيص تستعلم أثناء جلسة إصلاح أبداً.
• اتفاقية مستوى الخدمة: تعمل واجهة API الخلفية على خادم VPS معزول، مستقلة عن الموقع العام الثابت.

دليل التكامل

يستغرق التكامل النموذجي من يوم عمل إلى خمسة: سجّل حساباً مجانياً، واطلب بيانات اعتماد تجريبية من صفحة الشراكة، واستدعِ نقطة نهاية بيئة الاختبار برقم VIN معروف للتحقق من تدفق التوقيع. فعلى سبيل المثال، يعيد فك ترميز VIN تويوتا كامري 2019 إصدار الطراز وبادئة VIN ذات 8 خانات ورابطاً إلى البطاقة التقنية في استجابة JSON واحدة.

1. سجِّل حساباً مجانياً على /shop/register.html — وسيصبح هوية فوترتك.
2. اطلب بيانات الاعتماد عبر الشراكة؛ وتُصدر المفاتيح التجريبية خلال يوم عمل واحد.
3. وقِّع الطلبات بخوارزمية HMAC-SHA256 على timestamp + method + path + body؛ ويُقدَّم موقّع مرجعي بلغتي Python وJavaScript.
4. انتقل للإنتاج باستبدال عنوان URL الأساسي لبيئة الاختبار؛ ويُقاس الاستخدام في محفظة الرموز نفسها المستخدمة في متجر الويب.

يتحقق معظم الشركاء من التكامل بثلاثة أرقام VIN مرجعية — مطابقة بادئة دقيقة واحدة، ورجوع WMI واحد، ومرشح على مستوى العلامة واحد — لأن هذه الحالات الثلاث تمارس كل مسارات التعليمات البرمجية التي يمكن أن يسلكها المحلّل.

حالات الاستخدام

تشمل عمليات التكامل الحالية صانع أدوات تشخيص أوروبياً يفك ترميز أرقام VIN قبل المسح، ومتجر قطع يطابق الإدراجات بإصدارات الطرازات، ومجموعة موزعين تشغّل مركز البيانات كاملاً تحت CNAME بالعلامة البيضاء. وفي كل حالة تكون سطح التكامل متطابقاً — ويختلف فقط ملف الفوترة. وبالنسبة للحالات الثلاث تتطابق حداثة البيانات مع الموقع العام، لأن استجابات API تُقدَّم من مجموعة البيانات نفسها التي حُدِّثت بتاريخ 15 أكتوبر 2026.

• أدوات التشخيص — حدّد المركبة أولاً، ثم حمّل تعريفات DTC ومخططات الأسلاك الخاصة بالطراز.
• تجارة القطع الإلكترونية — اربط رقم VIN للعميل بإصدار الطراز الدقيق لإلغاء مرجعات القطع الخاطئة.
• بوابات الموزعين — أبقِ عملاء الصيانة على موقع الموزع بوثائق ورشة بعلامته البيضاء.

بيئة الاختبار والتجربة

يبدأ كل تكامل في بيئة اختبار مجانية تعكس شكل بيانات الإنتاج لكنها تستجيب بمجموعة ثابتة من أرقام VIN المرجعية، فتستطيع البناء والاختبار دون إنفاق رمز واحد. وعلاوة على ذلك، تعيد بيئة الاختبار نفس بيانات مستوى المطابقة الموجودة في الإنتاج، أي أن منطق عرض الثقة لديك يُختبر على حالات رجوع حقيقية قبل الإطلاق.

• مفاتيح تجريبية مجانية — تُصدر خلال يوم عمل واحد عبر الشراكة؛ دون حاجة إلى عقد أو التزام بحجم.
• أرقام VIN مرجعية — مجموعة موثقة تغطي المطابقات الدقيقة للبادئة، والرجوع إلى WMI، والمرشحين على مستوى العلامة — واحد لكل مستوى مطابقة.
• موقّعون مرجعيون — أمثلة جاهزة للصق لتوقيع HMAC-SHA256 بلغتي Python وJavaScript، مع مجموعة Postman لاختبارات سريعة.
• اختبار بتكلفة صفر — لا تُقاس استدعاءات بيئة الاختبار أبداً؛ وتبدأ فوترة الإنتاج فقط بعد استبدال عنوان URL الأساسي.

الأسئلة الشائعة