التوثيق
توثيق EnCarAPI. تعلم كيفية الوصول إلى بيانات السيارات الكورية عبر نقاط نهاية API المباشرة. أدلة التكامل وأمثلة الكود.
خبرة في الصناعة
مزود API لبيانات السيارات مع سنوات من الخبرة في السوق الكوري.
دعم 7 أيام
فريق دعم متاح 7 أيام في الأسبوع للمساعدة في تكامل API.
خدمة 24/7
مراقبة على مدار الساعة لتوصيل بيانات موثوق.
تنبيهات القوائم في الوقت الفعلي
احصل على وصول فوري عبر API إلى قوائم السيارات الجديدة فور نشرها.
تنزيلات CSV
نزّل قوائم الماركات والطُرز والشارات بصيغة CSV - احفظها في الذاكرة المؤقتة وتجنّب استدعاءات الفئات المباشرة.
صيغ تصدير مرنة
احصل على البيانات بصيغ CSV وJSON وExcel وصيغ مخصصة للتكامل السهل.
عنوان URL الأساسي
تتم جميع طلبات API إلى عنوان URL الأساسي التالي:
https://api.encarapi.comعلى سبيل المثال، لجلب العروض:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=trueالمصادقة
قم بمصادقة طلباتك باستخدام مفتاح API. مرره كمعامل استعلام أو عبر رأس Authorization.
# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"
# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEYسير عمل التكامل
اتبع هذه الخطوات الأربع للتكامل مع EnCarAPI.
الحصول على الفلاتر المتاحة
استرجع جميع قيم الفلاتر الممكنة (العلامات التجارية، الموديلات، التكوينات، الألوان، إلخ.)
GET /filtersالحصول على قوائم المركبات
جلب القوائم المرقمة مع فلاتر اختيارية للعلامة التجارية والموديل والسنة والسعر والمزيد.
GET /offers?page=1تتبع التغييرات
احصل على معرّف تغيير لتاريخ معين، ثم استعلم عن القوائم المضافة والمعدّلة والمحذوفة.
GET /change_id → GET /changesالحصول على تفاصيل القائمة
جلب التفاصيل الكاملة لقائمة محددة عبر inner_id الخاص بها.
GET /offer?inner_id=...نقاط نهاية API
جميع نقاط النهاية المتاحة للوصول إلى بيانات المركبات الكورية.
بيانات القوائم المنسدلة (CSV)
نزّل قوائم الماركات والطُرز والشارات بصيغة CSV، واحفظها في الذاكرة المؤقتة، وابنِ منها قوائمك المنسدلة - دون استدعاءات فئات مع كل نقرة ودون مطابقة يدوية دون اتصال. يتضمّن كل ملف عمود عدد، ويحمل ملف الشارات توزيع نوع الهيكل (Coupe / Sedan / Cabrio).
نزّلها مرة واحدة واحفظها في الذاكرة المؤقتة - يُحدَّث يومياً
جميع الماركات مع أعداد القوائم
جميع تركيبات الماركات والطُرز مع الأعداد
جميع قيم الماركات والطُرز والشارات (بما في ذلك Coupe / Sedan / Cabrio) مع الأعداد
أضف مفتاح API الخاص بك للتنزيل - أضف ?api_key=YOUR_KEY إلى رابط الملف. الملفات محمية بمفتاح، ولا يمكن لأحد تنزيلها بدون مفتاح صالح.
حداثة البيانات
يُحدَّث الكتالوج (الأسعار، عدد الكيلومترات، الإعلانات الجديدة والمباعة) كل 5 ساعات تقريباً، مع مسح أعمق مرة واحدة يومياً. تتبع تفاصيل السيارة (المواصفات، الصور، الحالة، تقرير الحوادث) دورتها الخاصة الأبطأ - عادة خلال 3 أسابيع من حدوث تغيير، وأسرع إذا أشار الكتالوج إلى شيء مهم.
نطاق الكتالوج
يشمل الكتالوج قوائم البيع القياسي فقط (نوع البيع «일반» في Encar). لا تُدمَج ضمنه قوائم نقل عقود الإيجار التمويلي («리스») والتأجير («렌트») - إذ يُحدَّد سعرها بالدفعة الشهرية بدلاً من سعر الشراء، وهو ما سيُشوِّه حقل Price. استخدم GET /api/catalog/leasing لهذه القوائم بدلاً من ذلك.
مدة التخزين المؤقت
- قيم التصفية وملفات التصنيف CSV و/api/nav: خزّنها مؤقتاً لمدة 24 ساعة
- قوائم السيارات (/api/catalog): خزّنها مؤقتاً لمدة 4 إلى 6 ساعات
- تفاصيل السيارة (/api/vehicle/:id): خزّنها مؤقتاً لمدة 24 ساعة
هذا هو نموذج Starter: قدّم القوائم من قاعدة بياناتك الخاصة وحدّثها بهذه الوتيرة بدلاً من الاستدعاء المباشر مع كل نقرة من المستخدم. يوجد حد يومي لحجم الكتالوج في هذه الخطة - فهي مخصصة للاستعلامات المباشرة، وليس للاحتفاظ بنسخة محلية كاملة.
هل تحتاج إلى نسخة محلية كاملة بدلاً من ذلك؟
تتضمّن خطتا Business وScale GET /api/catalog/export (لقطة CSV كاملة يومية لا تُحتسب ضمن الحد اليومي) وGET /api/catalog/changes?since=... (القوائم المُضافة والمُحدَّثة والتي ظهرت من جديد والمُزالة منذ آخر مزامنة لك). املأ قاعدة بياناتك من ملف التصدير مرة واحدة، ثم استعلم عن التغييرات للحفاظ عليها محدّثة - دون الحاجة لإعادة سحب الكتالوج بالكامل مجدداً. كما تُلغي خطة Scale الحد اليومي لحجم الكتالوج بالكامل.
القوائم المكررة
يقوم التجار الكوريون غالباً بنشر نفس السيارة الفعلية مرتين تحت معرّفي قائمة مختلفين لزيادة الظهور - بنفس السعر والمسافة المقطوعة وسنة الصنع والموديل/الفئة. نكتشف هذه الحالات ونضع علامة على النسخ الإضافية بـ IsDuplicate: true وDuplicateOf: <معرّف القائمة الأصلية> على عنصر الكتالوج؛ وتبقى القائمة الأصلية دون علامة. تُوضع علامة على التكرارات ولا تُحذف، لتقرر بنفسك كيفية التعامل معها - مرّر exclude_duplicates=true إلى /api/catalog أو /api/catalog/leasing لاستبعادها من جانب الخادم.
الأسئلة المتكررة
مستعد للبدء؟
تواصل معنا على تيليجرام للحصول على بيانات اعتماد API الخاصة بك وابدأ بالوصول إلى بيانات السيارات الكورية اليوم.