API ya uingizaji ya Bwatoo

Tuma katalogi yako kwa duka lako la Bwatoo kutoka kwenye mashine ya mauzo, duka la mtandaoni au programu ya usimamizi.

Uthibitishaji

Unda ufunguo katika Duka langu, Funguo za API. Utume katika kichwa cha Authorization. Ufunguo wa majaribio (bw_test_…) hukagua utumaji na kurudisha ripoti bila kuchapisha chochote.

Authorization: Bearer bw_live_…

Kutuma bidhaa

Bidhaa 100 zaidi kwa ombi moja. Bidhaa huundwa, au husasishwa ikiwa ina external_id inayojulikana.

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}

Kategoria na sifa hufuata kanuni zilezile za kuweka tangazo kwenye tovuti: sifa za kategoria hupatikana kwa GET /api/v1/categories//attributes.
Sarafu lazima iwe ya nchi ya duka. Hakuna namba ya simu wala barua pepe katika maandishi.
Picha ni anwani za umma za https; Bwatoo huzipakua, huzikagua na kuzipunguza ukubwa.
full_feed: bidhaa za duka zisizo kwenye utumaji husimamishwa, kamwe hazifutwi.
Hisa na aina: kifurushi cha Business.
Agizo la mapema kutoka nje (Pro na Business): ships_from (msimbo wa nchi ISO, kwa mfano CN), delivery_days_min na delivery_days_max (siku, 120 kwa juu). Muda wa juu ni lazima bidhaa inapotoka nchi nyingine. Bwatoo inaonyesha «Inasafirishwa kutoka: Uchina · siku 45 hadi 60» na haitoi wasafirishaji wake wa ndani.

Kila bidhaa hupata matokeo: created, updated, unchanged, pending (ukaguzi wa timu) au rejected pamoja na sababu.

Njia nyingine

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — husimamisha bidhaa
GET /api/v1/shop/imports/{id} — ripoti ya kundi

Faili na mlisho

Bidhaa hizohizo zinaweza kutumwa kwa CSV, Excel, XML au JSON kutoka Duka langu, Ingiza. Safu:

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

Thamani nyingi hutenganishwa kwa mstari wima (|). Business: Bwatoo husoma mlisho wako wa mbali kila saa 6.

Viwango

Pro: uundaji 100 kwa siku na 20 kwa saa. Business: 2,000 kwa siku na 300 kwa saa. Zaidi ya uundaji 50 kwa saa, matangazo mapya hukaguliwa na timu.

Webhooks (Business)

Matukio: message.received, offer.received, offer.accepted, stock.out, listing.paused. Maandishi ya ujumbe hayatumwi kamwe. Kagua sahihi kabla ya kushughulikia utumaji:

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

Jibu kwa msimbo wa 2xx. Ikishindikana, Bwatoo hujaribu tena mara 5, kwa muda unaoongezeka.