API ya bokotisi ya Bwatoo

Tinda katalogi na yo na butiki na yo ya Bwatoo uta na caisse, butiki na yo ya internet to logiciel na yo ya bokambi.

Kondimisa

Sala fungola na Butiki na ngai, Bafungola ya API. Tinda yango na Authorization. Fungola ya komeka (bw_test_…) etalaka botindi mpe ezongisaka rapport kozanga kobimisa eloko.

Authorization: Bearer bw_live_…

Kotinda biloko

Biloko 100 mingi koleka na bosenga moko. Eloko esalemaka, to ebongisamaka soki ezali na external_id oyo eyebani.

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}

Molongo mpe bizaleli elandaka mibeko moko na oyo ya kotya esakola na site: bizaleli ya molongo emonisamaka na GET /api/v1/categories//attributes.
Mbongo esengeli kozala ya mboka ya butiki. Nimero ya telefone to e-mail te na makomi.
Bafoto ezali ba adresi https ya bato nyonso; Bwatoo ekitisaka yango, etalaka yango mpe ebongisaka bonene na yango.
full_feed: biloko ya butiki oyo ezali na botindi te etɛlɛmisamaka, elongolamaka soki moke te.
Stock mpe mitindo: abonnement Business.
Kosenga liboso uta na mboka mopaya (Pro mpe Business): ships_from (code ya mboka ISO, ndakisa CN), delivery_days_min mpe delivery_days_max (mikolo, 120 koleka te). Ntango ya suka esengeli soki eloko euti na mboka mosusu. Bwatoo emonisaka « Etindami uta: Chine · mikolo 45 tii 60 » mpe epesaka te batindi na yango ya mboka.

Eloko moko moko ezwaka mbano: created, updated, unchanged, pending (botali ya ekipi) to rejected na ntina.

Banzela mosusu

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — etɛlɛmisi eloko
GET /api/v1/shop/imports/{id} — rapport ya lisanga

Bafisye mpe ba flux

Biloko yango moko ekoki kotindama na CSV, Excel, XML to JSON uta na Butiki na ngai, Kotisa. Makolo:

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

Motuya ebele ekabwanaka na molɔngɔ ya kotɛlɛma (|). Business: Bwatoo etangaka flux na yo ya mosika ngonga 6 nyonso.

Ndelo

Pro: bisakola 100 na mokolo mpe 20 na ngonga. Business: 2 000 na mokolo mpe 300 na ngonga. Soki eleki 50 na ngonga, bisakola ya sika etalamaka na ekipi.

Webhooks (Business)

Makambo: message.received, offer.received, offer.accepted, stock.out, listing.paused. Maloba ya nsango etindamaka soki moke te. Talá sinyatili liboso ya kosala botindi:

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

Zongisa na kode 2xx. Soki elongi te, Bwatoo emekaka lisusu mbala 5, na ntango oyo ezali kobakisama.