التوثيق | AUTO-API.COM

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

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

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

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

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

دعم 7 أيام

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حقول البيانات المتاحة

توفر واجهتنا البرمجية وصولاً لنقاط البيانات الكاملة، بما في ذلك:

سمات السيارة الأساسية

  • الصانع والموديل
  • السنة والجيل
  • الفئة والمواصفات
  • نمط الهيكل
  • اللون الخارجي

المواصفات التقنية

  • نوع المحرك والسعة
  • القوة الحصانية
  • ناقل الحركة
  • نظام الدفع
  • قراءة عداد المسافات

بيانات إعلانات السوق

  • السعر والعملة
  • رابط الإعلان ومعرّفه
  • التوفر
  • تاريخ النشر
  • الوصف الكامل

تفاصيل البائع والموقع

  • المنطقة والمدينة
  • نوع البائع (وكالة/فردي)
  • معلومات الاتصال
  • تاريخ السيارة
  • الصور والخيارات

* يختلف توافر حقول البيانات حسب سوق المصدر واكتمال الإعلان.

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

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

يتم الاحتفاظ بملفات التصدير مع تخزين آمن لمدة 3 أيام كحد أدنى بالإضافة إلى نظام أرشفة تلقائي.

توفر التصدير

تصديرات البيانات اليومية مع محتوى محدث متاح للتنزيل كل يوم

تفاصيل تنسيق CSV

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

بنية الرابط:

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

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

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

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

  • CSV - CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

مثال طلب cURL للواجهة البرمجية

curl -L -X GET 'https://{personal_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://{personal_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
توثيق الواجهة البرمجية الآنية

معاملات طلب الواجهة البرمجية

api_key - مفتاح الواجهة البرمجية الفريد للمصادقة.

from_id - معرّف التغيير لجلب البيانات منه. استخدم 0 للطلب الأولي، ثم آخر معرّف مستلم + 1.

حقول استجابة الواجهة البرمجية

inner_id - المعرّف الدائم الفريد للإعلان على سوق المصدر.

change_type - نوع الحدث: "added" (مضاف)، "changed" (متغير مثل تحديث السعر)، أو "removed" (محذوف).

created_at - الطابع الزمني الذي يشير إلى وقت حدوث الحدث.

مثال جسم الاستجابة

{
  "result": [
    {
      "id": 2664810,
      "inner_id": "40428521",
      "change_type": "added",
      "created_at": "2025-09-02T05:44:49.000",
      "data": {
        "id": "1455502",
        "inner_id": "40428521",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40428521",
        "mark": "Hyundai",
        "model": "Genesis",
        "generation": "200 Turbo S",
        "configuration": "200 Turbo S",
        "complectation": null,
        "year": "2012",
        "color": "Red",
        "price": "8900000",
        "km_age": "246400",
        "engine_type": "Gasoline",
        "transmission_type": "Manual",
        "body_type": "Sports Car",
        "address": "Busan Dongnae-gu",
        "seller_type": "REPEAT",
        "is_dealer": "false",
        "section": "used",
        "seller": "cainabel",
        "salon_id": "05062013358",
        "description": "I'm not a dealer; I'm an individual who loves cars...",
        "displacement": "1998.0",
        "offer_created": "2025-09-02T05:44:49.000",
        "manufacturerName": "Hyundai",
        "modelName": "The New Genesis Coupe",
        "gradeName": "200 Turbo S",
        "modelGroupName": "Genesis",
        "yearMonth": "201203",
        "images": [
          {
            "code": "001",
            "path": "/carpicture02/pic4042/40428521_001.JPG",
            "type": "OUTER"
          }
        ],
        "advertisementType": "NORMAL",
        "created_at": "2025-09-02T00:47:21.243",
        "extra": "{diagnosis:{...},inspection:{...},accidents:[...]}",
        "options": {
          "standard": [
            "001",
            "003",
            "006",
            "007",
            "008"
          ],
          "choice": [
            "1052"
          ],
          "tuning": [
            "015",
            "016",
            "017",
            "018",
            "021"
          ]
        }
      }
    },
    {
      "id": 2664811,
      "inner_id": "39969819",
      "change_type": "changed",
      "created_at": "2025-08-17T05:19:34.442",
      "data": {
        "new_price": 34900000
      }
    },
    {
      "id": 2664812,
      "inner_id": "39971229",
      "change_type": "removed",
      "created_at": "2025-08-17T05:19:39.778"
    }
  ],
  "meta": {
    "cur_from_id": "2664810",
    "limit": 10
  }
}