التوثيقمرجع API

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

نقدم بيانات سيارات نظيفة ومنظمة مباشرة عبر الواجهة البرمجية. هذا يغنيك عن الحاجة للإعداد المعقد، أو إدارة البنية التحتية، أو الصيانة التقنية.

لماذا تختارنا

خبرة في المجال

مزود لواجهة بيانات السيارات البرمجية مع أكثر من 8 سنوات من الخبرة منذ 2017.

دعم 7 أيام

فريق الدعم المتخصص لدينا متاح 7 أيام في الأسبوع للمساعدة في تكامل الواجهة البرمجية الخاصة بك.

موثوقية الخدمة 24/7

المراقبة المستمرة على مدار الساعة تضمن أقصى وقت تشغيل لتوصيل للبيانات.

قدرات الواجهة البرمجية الرئيسية | مستخرجات ومحللات

تنبيهات الإعلانات الآنية

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

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

احصل على تصديرات يومية للإعلانات النشطة والمُزالة لتحليل السوق وتتبع المبيعات.

تنسيقات تصدير مرنة

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

الأسئلة الشائعة | الواجهة البرمجية مقابل المستخرج وبرنامج الزحف

كيف تعمل واجهة السيارات البرمجية؟

الواجهة البرمجية تعطيك بيانات آنية من أكبر أسواق السيارات. بيانات منظمة بـ REST API للتحليل الفوري.

ما مجموعات البيانات التي توفرها واجهة السيارات البرمجية؟

بيانات السيارات تشمل المواصفات، الأسعار، معلومات البائع، الموقع، والكيلومترات. ملايين الإعلانات من المنصات الرئيسية بـ API.

هل هناك حدود استخدام لواجهة السيارات البرمجية؟

لا توجد حدود استخدام مع تنظيم معدل الطلبات. جميع الإعلانات النشطة متاحة بالواجهة الآنية أو التصديرات اليومية. لا قيود لشركاء المؤسسات.

كيف يمكنني تتبع إعلانات السيارات الجديدة مع الواجهة البرمجية الآنية؟

راقب الإعلانات باستخدام معامل 'change_id'. ابدأ بـ change_id=0، ثم استخدم آخر معرف تغيير مستلم + 1. يرصد الإعلانات الجديدة، وتغيرات الأسعار، والإزالات عبر المنصات.

ما تنسيقات البيانات التي تدعمونها؟

البيانات متاحة بتنسيقات CSV، JSON، Excel، وقواعد البيانات. جميع التنسيقات تشمل بيانات من كل المنصات.

هل يمكنكم توفير وصول واجهة برمجية مخصصة لسوق معين؟

نعم، نبني حلول واجهات برمجية مخصصة لأي سوق سيارات. احصل على وصول لبيانات مخصصة لاحتياجاتك المحددة. تواصل معنا لمناقشة المتطلبات.

هل يبقى استخدامي للبيانات وشراكتي سرياً؟

نعم. نعمل بموجب اتفاقيات سرية صارمة مع جميع العملاء. يبقى استخدامك لخدمات بيانات السيارات الخاصة بنا خاصاً وآمناً تماماً.

هل أحتاج لإدارة أي بنية تحتية أو خوادم؟

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

API Reference

الرابط الأساسي

https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}

التفويض: api_key parameter

سير العمل

1
/filtersالحصول على قيم الفلتر المتاحة
2
/offersالحصول على القوائم (مع أو بدون فلاتر) - استخدم للتحميل الأولي للبيانات
3

للتحديثات (الحفاظ على تحديث البيانات بعد التحميل الأولي):

/change_id?date=...الحصول على معرف البداية لتغذية التغييرات
/changes?change_id=...الحصول على جميع التغييرات في قاعدة البيانات بدءاً من المعرف
4
/offerالحصول على تفاصيل قائمة محددة بواسطة inner_id

نهج التكامل الموصى به:

1. أولاً، استخدم /offers لجلب البيانات الأولية (تصفح جميع الصفحات)

2. ثم استخدم /changes للحصول الدوري على جميع التغييرات (المضافة/المعدّلة/المحذوفة) لمزامنة قاعدة بياناتك المحلية مع المصدر

3. لدمج البيانات في موقعك الإلكتروني، يمكنك استخدام /offers مع الفلاتر والتصفح (العلامة التجارية، الطراز، السعر، السنة، إلخ)

GET/filters

إرجاع جميع القيم الممكنة للتصفية

https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEY

الاستجابة:

{
  "mark": {
    "Hyundai": {
      "model": {
        "Sonata": {
          "configuration": {
            "DN8": { "complectation": ["Smart", "Modern", "Premium"] }
          }
        }
      }
    },
    "Kia": {
      "model": {
        "K5": {
          "configuration": {
            "DL3": { "complectation": ["LX", "EX", "SX"] }
          }
        }
      }
    }
  },
  "transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
  "color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
  "body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}

GET/offers

قائمة الإعلانات مع ترقيم الصفحات والفلاتر

المعاملات:

  • page (مطلوب) - رقم الصفحة
  • mark, model, configuration, complectation - filters (غير حساس لحالة الأحرف)
  • transmission_type, color, body_type, engine_type - filters (غير حساس لحالة الأحرف)
  • year_from, year_to - فلتر نطاق السنوات
  • km_age_from, km_age_to - فلتر نطاق المسافة المقطوعة
  • price_from, price_to - فلتر نطاق الأسعار (بوحدات 10,000 وون كوري)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=black

الاستجابة:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

حقول البيانات:

  • id - معرف قاعدة البيانات الداخلي
  • inner_id - معرف الإعلان على المنصة
  • url - رابط الإعلان
  • mark - ماركة السيارة
  • model - موديل السيارة
  • generation - الجيل
  • configuration - التكوين
  • complectation - مستوى التجهيز
  • year - سنة الإنتاج
  • color - اللون
  • price - السعر (بوحدات 10,000 وون كوري)
  • price_won - السعر الكامل بالوون الكوري
  • km_age - المسافة المقطوعة بالكيلومتر
  • engine_type - نوع المحرك
  • transmission_type - نوع ناقل الحركة
  • body_type - نوع الهيكل
  • address - العنوان
  • seller_type - نوع البائع
  • is_dealer - علامة الوكيل (true/false)
  • section - القسم
  • seller - البائع
  • salon_id - معرف الوكيل
  • description - الوصف
  • displacement - سعة المحرك (cc)
  • offer_created - تاريخ إنشاء الإعلان
  • images - مصفوفة روابط الصور
  • extra - بيانات إضافية (JSON)
  • options - قائمة الخيارات

GET/change_id

الحصول على أول معرف تغيير حسب التاريخ (للاستخدام في /changes)

المعاملات:

  • date (مطلوب) - التاريخ بتنسيق yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15

الاستجابة:

{ "change_id": 1547283 }

استخدم القيمة المرجعة كمعامل change_id في /changes

GET/changes

تغذية التغييرات (مضاف/معدل/محذوف)

المعاملات:

  • change_id (مطلوب) - بدءاً من أي معرف تغيير
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1

الاستجابة:

{
  "result": [
    {
      "id": 456,
      "inner_id": "40427050",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "40427051",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490 }
    },
    {
      "id": 458,
      "inner_id": "40427052",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

إعلان فردي بواسطة inner_id

المعاملات:

  • inner_id (مطلوب)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050

الاستجابة: كائن data (مثل /offers، ولكن بدون غلاف result)

احصل على القائمة بواسطة الرابط

استرجع بيانات القائمة الكاملة من خلال توفير الرابط الأصلي من أي منصة مدعومة. مثالي لعمليات البحث السريعة واسترجاع قائمة واحدة.

الرابط الأساسي

https://{access_name}.auto-api.com/api/v1/offer/info

الترخيص عبر رأس x-api-key

POST/api/v1/offer/info

أرسل طلب POST مع رابط القائمة للحصول على البيانات الكاملة

المعاملات:

  • url (مطلوب) - رابط القائمة على أي منصة مدعومة

مثال على الطلب:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'

الاستجابة:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

حقول البيانات:

  • inner_id - معرف الإعلان على المنصة
  • url - رابط الإعلان
  • mark - ماركة السيارة
  • model - موديل السيارة
  • generation - الجيل
  • year - سنة الإنتاج
  • year_month - سنة وشهر الإنتاج
  • color - اللون
  • price - السعر بوحدات 10000 وون كوري
  • km_age - المسافة المقطوعة بالكيلومتر
  • engine_type - نوع المحرك
  • transmission_type - نوع ناقل الحركة
  • body_type - نوع الهيكل
  • displacement - سعة المحرك (سم مكعب)
  • power - القدرة بالحصان
  • vin - رمز VIN
  • address - العنوان
  • seller_type - نوع البائع
  • is_dealer - علامة الوكيل (true/false)
  • offer_created - تاريخ إنشاء الإعلان
  • images - مصفوفة روابط الصور
التصديرات اليومية

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

الملفات مخزنة لمدة 3 أيام على الأقل

جدول توافر الواجهة البرمجية

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

تنسيق بيانات CSV

ملفات CSV تستخدم الأنبوب (|) كفاصل أعمدة

بنية الرابط:

https://{access_name}.auto-api.com/{date}/{file_name}

معاملات الطلب:

  • access_name - معرف النطاق الفرعي المخصص لك
  • date - التاريخ المطلوب بتنسيق yyyy-mm-dd (مثال: 2025-09-06)
  • file_name - اسم ملف التصدير مع الامتداد

التنسيقات المتاحة:

  • 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

مثال طلب cURL API

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

أمر تحميل Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'