التوثيق
توثيق 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 إلى رابط الملف. الملفات محمية بمفتاح، ولا يمكن لأحد تنزيلها بدون مفتاح صالح.
حداثة البيانات
يُحدَّث الكتالوج الكامل كل يوم، وتُلتقط أحدث القوائم كل ساعتين، وتُزال السيارات المباعة كل ساعة.
مدة التخزين المؤقت
- قيم التصفية وملفات التصنيف CSV و/api/nav: خزّنها مؤقتاً لمدة 24 ساعة
- قوائم السيارات (/api/catalog): خزّنها مؤقتاً لمدة ساعة إلى ساعتين
- تفاصيل السيارة (/api/vehicle/:id): خزّنها مؤقتاً لمدة 24 ساعة
قدّم القوائم من قاعدة بياناتك الخاصة وحدّثها بهذه الوتيرة بدلاً من الاستدعاء المباشر مع كل نقرة من المستخدم.
الأسئلة المتكررة
مستعد للبدء؟
تواصل معنا على تيليجرام للحصول على بيانات اعتماد API الخاصة بك وابدأ بالوصول إلى بيانات السيارات الكورية اليوم.