انتقل إلى المحتوى

الأدلة

مزامنة المخزون كاملًا

تغذيتان تُبقيان الكتالوج المحلي محدّثًا: /cars للمخزون النشط و/archived-lots للإعلانات التي اختفت.

  1. 1

    ابنِ الكتالوج الأولي

    تنقّل بين صفحات /cars، مع simple_paginate=1 حين لا تحتاج الأعداد الإجمالية. خزّن معرّف المركبة والمصدر ومعرّفات اللوت وأوقات التحديث.

  2. 2

    اجمع التحديثات

    استعلم عن /cars?minutes=60 لنافذة ساعة واحدة، أو اختر نافذة تناسب فاصل الاستعلام لديك (1–4320 دقيقة). اقرأ كل صفحة بالفلاتر نفسها.

  3. 3

    عالج الإعلانات المؤرشفة

    استعلم عن /archived-lots?minutes=60 على نافذة مطابقة وعلّم ذلك اللوت في المصدر كغير نشط. أرشفة لوت واحد لا تعني أن كل إعلانات المركبة غير نشطة.

  4. 4

    طبّق التغييرات بأمان عند التكرار

    أدرج أو حدّث حسب المعرّفات. استخدم نوافذ متداخلة وأوقاتًا مخزّنة لتحمّل إعادة المحاولات والتكرارات.

  5. 5

    طابق دوريًا

    النافذة المتحركة ليست مؤشرًا دائمًا. بعد انقطاع أطول من 72 ساعة، أعِد بناء المخزون النشط بدلًا من الاعتماد على التغذية التزايدية.

أرشف على مستوى اللوت باستخدام lot_id، فقد تكون للمركبة لوتات أخرى نشطة. تحتوي استجابات الأرشيف القديمة على bid/sale_date كقيم مفردة، بينما تستخدم الأحدث {value, updated_at}. لا تفترض أن قيمة bid القديمة سعر بيع نهائي مؤكد.

مثال Python جاهز للتشغيل على الخادم: يتنقّل بين صفحات خلاصتَي البيانات، ويُدرج المركبات واللوتات أو يحدّثها في SQLite، ويؤرشف اللوت المعني فقط. يستخدم مفتاحاً من بيئة الخادم، ومهلات زمنية، وإعادة محاولة محدودة، ونقطة تحقق لآخر نجاح. ثبّت requests. اضبط AUCTIONS_API_KEY على الخادم، ثم شغّل python sync_auction_cars.py --initial مرة واحدة؛ وجدول التشغيلات اللاحقة بدون --initial. أحجام الصفحات الافتراضية: cars=50، الأرشيف=100. في باقة Unlimited يمكنك ضبط AUCTIONS_CARS_PER_PAGE=1000 و AUCTIONS_ARCHIVE_PER_PAGE=1000. شغّل عاملاً واحداً فقط في كل مرة (قفل في المجدول)؛ وكيّف تخزين SQLite وطابِق الفجوات التي تتجاوز 72 ساعة. هذا المثال لا يحوّل خلاصة البيانات المتغيرة إلى لقطة ثابتة.

© 2025. AuctionsAPI operates independently and is not affiliated with Copart, IAAI or Encar.