مرجع API

التوثيق

توثيق EnCarAPI. تعلم كيفية الوصول إلى بيانات السيارات الكورية عبر نقاط نهاية API المباشرة. أدلة التكامل وأمثلة الكود.

خبرة في الصناعة

مزود API لبيانات السيارات مع سنوات من الخبرة في السوق الكوري.

دعم 7 أيام

فريق دعم متاح 7 أيام في الأسبوع للمساعدة في تكامل API.

خدمة 24/7

مراقبة على مدار الساعة لتوصيل بيانات موثوق.

تنبيهات القوائم في الوقت الفعلي

احصل على وصول فوري عبر API إلى قوائم السيارات الجديدة فور نشرها.

تصديرات بيانات يومية

احصل على تصديرات يومية للقوائم النشطة والمحذوفة لتحليل السوق.

صيغ تصدير مرنة

احصل على البيانات بصيغ CSV وJSON وExcel وصيغ مخصصة للتكامل السهل.

عنوان URL الأساسي

تتم جميع طلبات API إلى عنوان URL الأساسي التالي:

url

https://encarapi.com/api/v2/encar

على سبيل المثال، لجلب العروض:

http

GET https://encarapi.com/api/v2/encar/offers?page=1&api_key=YOUR_API_KEY

المصادقة

قم بمصادقة طلباتك باستخدام مفتاح API. مرره كمعامل استعلام أو عبر رأس Authorization.

bash

GET https://encarapi.com/api/v2/encar/offers?api_key=YOUR_API_KEY

# Or via header:
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://encarapi.com/api/v2/encar/offers?page=1

سير عمل التكامل

اتبع هذه الخطوات الأربع للتكامل مع EnCarAPI.

الحصول على الفلاتر المتاحة

استرجع جميع قيم الفلاتر الممكنة (العلامات التجارية، الموديلات، التكوينات، الألوان، إلخ.)

GET /filters

الحصول على قوائم المركبات

جلب القوائم المرقمة مع فلاتر اختيارية للعلامة التجارية والموديل والسنة والسعر والمزيد.

GET /offers?page=1

تتبع التغييرات

احصل على معرّف تغيير لتاريخ معين، ثم استعلم عن القوائم المضافة والمعدّلة والمحذوفة.

GET /change_id → GET /changes

الحصول على تفاصيل القائمة

جلب التفاصيل الكاملة لقائمة محددة عبر inner_id الخاص بها.

GET /offer?inner_id=...

نقاط نهاية API

جميع نقاط النهاية المتاحة للوصول إلى بيانات المركبات الكورية.

التصديرات اليومية

قم بتنزيل تصديرات بيانات كاملة بصيغ متعددة. يتم إنشاء الملفات يومياً وهي متاحة للتنزيل.

الاحتفاظ بالبيانات

يتم تخزين الملفات لمدة 3 أيام أو أكثر كحد أدنى.

تحديثات يومية

ملفات يومية جديدة متاحة للتنزيل.

صيغة CSV

ملفات CSV تستخدم الشريط العمودي (|) كفاصل أعمدة.

ملفات التصدير المتاحة

الصيغة	جميع النشطة	الجديدة اليومية	المحذوفة اليومية
CSV	`all_active.csv`	`new_daily.csv`	`removed_daily.csv`
JSON	`all_active.json`	`new_daily.json`	`removed_daily.json`
Excel	`all_active.xlsx`	`new_daily.xlsx`	`removed_daily.xlsx`

أمثلة التنزيل

bash

# Download all active listings as CSV
curl -L -X GET 'https://encarapi.com/2025-03-15/all_active.csv' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o daily_car_data.csv

bash

# Download new daily listings as JSON
curl -L -X GET 'https://encarapi.com/2025-03-15/new_daily.json' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -o new_listings.json

bash

# Using wget
wget --method GET \
  --header 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  'https://encarapi.com/2025-03-15/all_active.xlsx'

الأسئلة المتكررة

مستعد للبدء؟

تواصل معنا على تيليجرام للحصول على بيانات اعتماد API الخاصة بك وابدأ بالوصول إلى بيانات السيارات الكورية اليوم.

التواصل على تيليجرام