API dugal bu Bwatoo

Yónneel sa katalog ci sa bitig Bwatoo dale ci sa kees, sa bitig ci internet walla sa lojisyelu saytu.

Wóorlu

Sos ab caabi ci Sama bitig, Caabi API yi. Yónne ko ci Authorization. Caabi jéem (bw_test_…) dafay saytu say yónnent te delloo rapoor bi te du génne dara.

Authorization: Bearer bw_live_…

Yónne ay njaay

100 njaay lu ëpp ci benn laaj. Dañuy sos njaay mi, walla ñu yeesal ko su amee external_id bu ñu xam.

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

Xeet wi ak melo yi dañuy topp ay sàrt yu ni mel ni yu dugal yéené ci site bi: melo yu benn xeet ñu ngi ci GET /api/v1/categories//attributes.
Xaalis bi war na doon bu réewu bitig bi. Amul nimero telefon walla e-mail ci mbind yi.
Nataal yi ay adrees https yu ñépp mën a jot lañu; Bwatoo dafay leen yebbi, saytu leen te defar seen dayo.
full_feed: njaayi bitig bi nekkul ci yónnent bi dañu leen di taxawal, duñu leen far mukk.
Stock ak xeet yi: abonmaa Business.
Dencal dale ci bitim-réew (Pro ak Business): ships_from (kodu réew ISO, misaal CN), delivery_days_min ak delivery_days_max (fan, 120 lu ëpp). Diir bu gëna yàgg bi war na su njaay mi jógee ci beneen réew. Bwatoo dafay wone « Yónne nañu ko dale: Chine · 45 ba 60 fan » te du joxe ay yónnekatam yu fii.

Njaay mu nekk am na njureef: created, updated, unchanged, pending (saytuwu ekip bi) walla rejected ak ngirte.

Yeneen yoon

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — dafay taxawal njaay mi
GET /api/v1/shop/imports/{id} — rapooru benn mbooloo

Fiise yi ak flux yi

Ñoom njaay yooyu mën nañu leen yónnee ci CSV, Excel, XML walla JSON dale ci Sama bitig, Dugal. Kolon yi:

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

Njëg yu bare dañu leen di xàjjale ak rëdd bu taxaw (|). Business: Bwatoo dafay jàng sa flux bu sore 6 waxtu yu nekk.

Dayo yi

Pro: 100 sos ci bés ak 20 ci waxtu. Business: 2 000 ci bés ak 300 ci waxtu. Bu weesoo 50 sos ci benn waxtu, yéené yu bees yi ekip bi dina leen saytu.

Webhooks (Business)

Xew-xew yi: message.received, offer.received, offer.accepted, stock.out, listing.paused. Mbindum bataaxal yi duñu ko yónnee mukk. Saytul xaatim bi balaa ngay jëfe yónnent bi:

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

Tontul ak kood 2xx. Bu antuwul, Bwatoo dina jéemaat 5 yoon, ak diir buy yokku.