تقارير تاريخ المركبات
Carfax وAutoCheck حسب VIN، عند الطلب.
افحص مجانًا عدد السجلات لدى كل مزوّد لرقم VIN، ثم اطلب التقرير الكامل فقط حين يستحق ذلك. تحصل على رابط لتقرير HTML، وملف PDF اختياري، ورصيدك بعد الخصم.
GET /reports/{type}/{vin}- html
- base64
- balance_after
كيف يعمل
- 1
افحص السجلات (مجانًا)
استدعِ
/reports/check-records/{vin}.يُعيد عدد سجلات Carfax وAutoCheck واسم المركبة. دون أي خصم. - 2
اطلب التقرير (مدفوع)
استدعِ
/reports/{type}/{vin}مع type بقيمة carfax أو autocheck. يُخصم سعر تقرير واحد من رصيدك بالدولار. - 3
استخدم النتيجة
افتح رابط html، وأضف pdf=1 حين تحتاج ملف PDF، واقرأ
balance_afterلتعرف المتبقي.
افحص VIN الآن
مجانًا: يحصي السجلات فقط.
GET /reports/check-records/{vin}رقم VIN تجريبي مجاني
استخدم هذا الرقم لتجربة الخطوتين. تقاريره مجانية.
الفوترة
- تُدفع التقارير من رصيد واحد بالدولار، مشترك مع Pay per VIN، وتعرضه
/reports/balance. - الطلبات check-records وbalance وmy-history مجانية.
- مع days=N يُعاد تقرير أنشأته خلال آخر N يومًا بدلًا من إنشاء تقرير جديد.
- عندما يكون الرصيد غير كافٍ يردّ API بالرمز 402 مع insufficient funds ولا يخصم شيئًا.
- عندما لا يملك المزوّد سجلًا لرقم VIN يردّ API بالرمز 400 مع records not found for this vin number ولا يخصم شيئًا.
مرجع API
معلومات مفيدة
- يجب أن يتكون VIN من 17 خانة بالضبط؛ أي طول آخر يُعيد 400.
- قد يستغرق pdf=1 من 40 إلى 60 ثانية. استخدم مهلة طويلة ولا ترسل الطلب نفسه مرتين: الطلب المكرر يتلقى 409 generation already in progress مع Retry-After.
- يحمل base64 جسم التقرير المشفّر. أضف
exclude_base_64=1حين تحتاج الروابط فقط. - قيمتا html وpdf روابط لملفات. احفظ الرابط أو الملف لديك.