I-API yokungenisa ye-Bwatoo

Thumela ikhathalogi yakho esitolo sakho se-Bwatoo kusuka esikhwameni sakho semali, esitolo sakho ku-inthanethi noma kusofthiwe yakho yokuphatha.

Imibhalo ye-API (OpenAPI)

Ukuqinisekisa ubuwena

Dala ukhiye ku-Isitolo sami, Okhiye be-API. Wuthumele kusihloko se-Authorization. Ukhiye wokuhlola (bw_test_…) uqinisekisa okuthunyelwe futhi ubuyisa umbiko ngaphandle kokushicilela lutho.

Authorization: Bearer bw_live_…

Thumela imikhiqizo

Imikhiqizo engu-100 ubuningi ngesicelo ngasinye. Umkhiqizo uyadalwa, noma ubuyekezwe uma unesi-external_id esesaziwa.

POST https://api.zm.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}

• Isigaba nezimfanelo zilandela imithetho efanayo nokufaka kuwebhusayithi: uhlu lwezimfanelo zesigaba lunikezwa ngu-GET /api/v1/categories//attributes.
• Imali kumele ibe ngeyezwe lesitolo. Ayikho inombolo yocingo noma i-imeyili emibhalweni.
• Izithombe zingamakheli e-https omphakathi; i-Bwatoo iyazilanda, izihlole futhi izishintshe usayizi.
• full_feed: imikhiqizo yesitolo engekho kokuthunyelwe iyamiswa okwesikhashana, ayisuswa neze.
• Isitoko nezinhlobo: iphakheji le-Business.
• Ukuoda kusenesikhathi kusuka phesheya (Pro ne-Business): ships_from (ikhodi yezwe ye-ISO, isibonelo CN), delivery_days_min kanye ne-delivery_days_max (izinsuku, ezingu-120 ubuningi). Isikhathi esiphezulu siyimpoqo uma umkhiqizo uqhamuka kwelinye izwe. I-Bwatoo ibonisa « Kuthunyelwe kusuka: eShayina · 45 kuya ku-60 izinsuku » futhi ayinikezi abalethi bayo bendawo.

Umkhiqizo ngamunye uthola umphumela: created, updated, unchanged, pending (ukuhlolwa yithimba) noma rejected nesizathu.

Eminye imizila

• GET /api/v1/shop/products?updated_since=
• GET /api/v1/shop/products/{external_id}
• DELETE /api/v1/shop/products/{external_id} — imisa umkhiqizo okwesikhashana
• GET /api/v1/shop/imports/{id} — umbiko weqoqo

Amafayela nokuphakelwa

Imikhiqizo efanayo ingathunyelwa nge-CSV, Excel, XML noma JSON kusuka ku-Isitolo sami, Ngenisa. Amakholomu:

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é>

Amanani amaningi ahlukaniswa ngomugqa omile (|). Business: i-Bwatoo iphinde ifunde ukuphakelwa kwakho kwekude njalo emahoreni angu-6.

Imikhawulo

Pro: okudaliwe okungu-100 ngosuku nokungu-20 ngehora. Business: okungu-2 000 ngosuku nokungu-300 ngehora. Ngaphezu kokudaliwe okungu-50 ehoreni, izikhangiso ezintsha zihlolwa yithimba.

Ama-webhook (Business)

Imicimbi: message.received, offer.received, offer.accepted, stock.out, listing.paused. Umbhalo wemilayezo awuthunyelwa neze. Hlola isiginesha ngaphambi kokucubungula okuthunyelwe:

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

Phendula ngekhodi engu-2xx. Uma kwehluleka, i-Bwatoo izama futhi izikhathi ezingu-5, ngesikhathi esikhulayo.