واجهة الاستيراد البرمجية من Bwatoo

أرسل كتالوجك إلى متجرك على Bwatoo من نقطة البيع أو متجرك الإلكتروني أو برنامج الإدارة.

المصادقة

أنشئ مفتاحًا من متجري، مفاتيح API. أرسله في الترويسة Authorization. يتحقق المفتاح التجريبي (bw_test_…) من الإرسال ويعيد التقرير دون نشر أي شيء.

Authorization: Bearer bw_live_…

إرسال المنتجات

100 منتج كحد أقصى لكل طلب. يُنشأ المنتج، أو يُحدَّث إذا كان يحمل external_id معروفًا.

POST https://api.cg.bwatoo.com/api/v1/shop/products
{"items": [{"external_id": "HLX-15", "category": "cars", "title": "Toyota Hilux 2015",
  "description": "…", "price": "8500000", "currency": "XAF", "city": "Libreville",
  "attributes": {"make": "toyota", "model": "hilux", "year": 2015},
  "photos": ["https://…/hilux.jpg"], "stock": 3}],
 "full_feed": false}

تخضع الفئة والسمات للقواعد نفسها المتبعة عند النشر على الموقع: تُعرض سمات الفئة عبر GET /api/v1/categories/<الفئة>/attributes.
يجب أن تكون العملة عملة بلد المتجر. لا أرقام هاتف ولا بريد إلكتروني في النصوص.
الصور عناوين https عامة؛ تنزلها Bwatoo وتتحقق منها وتعيد تحجيمها.
full_feed: تُوقف منتجات المتجر الغائبة عن الإرسال مؤقتًا ولا تُحذف أبدًا.
المخزون والأنواع: اشتراك Business.
الطلب المسبق من الخارج (Pro و Business): ships_from (رمز البلد ISO، مثل CN)، delivery_days_min و delivery_days_max (أيام، 120 كحد أقصى). المدة القصوى إلزامية عندما يُشحن المنتج من بلد آخر. يعرض Bwatoo «يُشحن من: الصين · 45 إلى 60 ي» ولا يقترح مندوبي التوصيل المحليين.

يحصل كل منتج على نتيجة: created أو updated أو unchanged أو pending (تحقق الفريق) أو rejected مع السبب.

مسارات أخرى

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — يوقف المنتج مؤقتًا
GET /api/v1/shop/imports/{id} — تقرير دفعة

الملفات والتدفقات

يمكن إرسال المنتجات نفسها بصيغة CSV أو Excel أو XML أو JSON من متجري، استيراد. الأعمدة:

external_id, category, title, description, price, currency, negotiable, city, district, photos, video_url, stock, delivery_days, ships_from, delivery_days_min, delivery_days_max, variants, attr_<clé>

تُفصل القيم المتعددة بخط عمودي (|). Business: تقرأ Bwatoo تدفقك البعيد كل 6 ساعات.

الحصص

Pro: 100 إنشاء يوميًا و20 في الساعة. Business: 2000 يوميًا و300 في الساعة. بعد 50 إنشاء في الساعة، تمر الإعلانات الجديدة بتحقق الفريق.

Webhooks (Business)

الأحداث: message.received وoffer.received وoffer.accepted وstock.out وlisting.paused. لا يُرسل نص الرسائل أبدًا. تحقق من التوقيع قبل معالجة أي إرسال:

X-Bwatoo-Signature: t=1760000000,v1=<hmac>

expected = hmac_sha256(secret, f"{t}.{body}")
ok = constant_time_equals(expected, v1) and abs(now - t) < 300

أجب برمز 2xx. عند الفشل، تعيد Bwatoo المحاولة 5 مرات بفاصل متزايد.