Bwatoo donni API

I ka katalogi ci i ka Bwatoo butiki ma ka bɔ i ka kɛsu, i ka butiki Internet kan walima i ka ɲɛmɔgɔya lojisiyɛli la.

Dɔnniya sɛgɛsɛgɛli

Kile dɔ dilan Ne ka butiki, API kilew la. A ci Authorization kunkolo la. Kɔrɔbɔli kile (bw_test_…) bɛ i ka ciw sɛgɛsɛgɛ ka rapɔri di k'a sɔrɔ foyi ma bila.

Authorization: Bearer bw_live_…

Fɛnw ci

Fɛn 100 dɔrɔn ɲinini kelen kɔnɔ. Fɛn bɛ dilan, walima a bɛ kuraya ni external_id dɔnnen dɔ b'a la.

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

Suguya ni a taamasiyɛnw bɛ sariya kelenw de labato i n'a fɔ bilali siti kan : suguya dɔ taamasiyɛnw lisi bɛ di GET /api/v1/categories//attributes fɛ.
Wari suguya ka kan ka kɛ butiki jamana ta ye. Telefɔni nimɔrɔ walima e-mail si kana kɛ sɛbɛnw kɔnɔ.
Jaw ye https adresi jɛlenw ye ; Bwatoo b'u ta, k'u sɛgɛsɛgɛ ani k'u bonya hakɛ yɛlɛma.
full_feed : butiki fɛn minnu tɛ ci in kɔnɔ, olu bɛ jɔ dɔɔnin, u tɛ jɔsi abada.
Maracogo ani fɛn suguya wɛrɛw : Business laɲini.
Ka a fɔ ka kɔn ka bɔ jamana wɛrɛ la (Pro ani Business) : ships_from (jamana kode ISO, misali la CN), delivery_days_min ani delivery_days_max (tile, 120 dɔrɔn). Waati jan kosɛbɛ ka kan ka sɛbɛn ni fɛn bɛ bɔ jamana wɛrɛ la. Bwatoo bɛ « A cilen bɔra : Siniwa · tile 45 ka se 60 ma » jira, a tɛ a ka lasebaga yɔrɔ in mɔgɔw laɲini.

Fɛn kelen kelen bɛɛ bɛ kɔlɔlɔ dɔ sɔrɔ : created, updated, unchanged, pending (jɛkulu bɛ a sɛgɛsɛgɛ) walima rejected ni a kun ye.

Sira wɛrɛw

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — fɛn jɔ dɔɔnin
GET /api/v1/shop/imports/{id} — ci dɔ rapɔri

Filenw ani flux

Fɛn kelenw bɛ se ka ci CSV, Excel, XML walima JSON la ka bɔ Ne ka butiki, Donni la. Kolɔnw :

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

Hakɛ caman bɛ faran ɲɔgɔn na ni sanfɛla jurusɛbɛn (|) ye. Business : Bwatoo bɛ i ka flux yɔrɔjan kalan lɛrɛ 6 o lɛrɛ 6.

Danw

Pro : dilanni 100 don o don ani 20 lɛrɛ o lɛrɛ. Business : 2 000 don o don ani 300 lɛrɛ o lɛrɛ. Ni dilanni tɛmɛna 50 kan lɛrɛ kelen kɔnɔ, kunnafoni kuraw bɛ tɛmɛ jɛkulu ka sɛgɛsɛgɛli fɛ.

Webhooks (Business)

Kow : message.received, offer.received, offer.accepted, stock.out, listing.paused. Cikanw sɛbɛn tɛ ci abada. Bolonɔ sɛgɛsɛgɛ sani i ka ci dɔ baara :

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

Jaabi ni kode 2xx ye. Ni a ma ɲɛ, Bwatoo bɛ a kɛ tugun siɲɛ 5, waati bɛ janya siɲɛ o siɲɛ.