I-API yokungenisa yeBwatoo

Thumela ikhathalogu yakho kwivenkile yakho yeBwatoo ukusuka kwikhawuntara yakho, kwivenkile yakho ye-intanethi okanye kwisoftwe yakho yolawulo.

Amaxwebhu e-API (OpenAPI)

Ukuqinisekiswa

Yenza isitshixo kwiVenkile yam, Izitshixo ze-API. Sithumele kwi-header ethi Authorization. Isitshixo sovavanyo (bw_test_…) siqinisekisa izinto ozithumelayo size sibuyise ingxelo ngaphandle kokupapasha nto.

Authorization: Bearer bw_live_…

Thumela iimveliso

Iimveliso ezili-100 ubuninzi kwisicelo ngasinye. Imveliso iyenziwa, okanye ihlaziywe ukuba ine-external_id esele yaziwa.

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

• Udidi neempawu zilandela imithetho efanayo nokufaka kwisayithi: uluhlu lweempawu zodidi lunikwa yi-GET /api/v1/categories//attributes.
• Imali kufuneka ibe yeyelizwe levenkile. Akukho nombolo yefowuni okanye i-imeyile kwimibhalo.
• Iifoto ziidilesi ze-https zikawonke-wonke; iBwatoo iyazikhuphela, izijonge ize itshintshe ubungakanani bazo.
• full_feed: iimveliso zevenkile ezingekhoyo kwinto ethunyelweyo ziyamiswa okwexeshana, azize zicinywe.
• Isitokhwe neentlobo: ipakeji yeBusiness.
• Uku-odola kwangaphambili ukusuka phesheya (Pro neBusiness): ships_from (ikhowudi yelizwe ye-ISO, umzekelo CN), delivery_days_min kunye ne-delivery_days_max (iintsuku, ezili-120 ubuninzi). Elona xesha likhulu liyanyanzeleka xa imveliso ivela kwelinye ilizwe. IBwatoo ibonisa «Ithunyelwe ukusuka: China · 45 ukuya ku-60 iintsuku» kwaye ayinikezeli ngabahambisi bayo basekuhlaleni.

Imveliso nganye ifumana isiphumo: created, updated, unchanged, pending (ijongwa liqela) okanye rejected nesizathu.

Ezinye iindlela

• GET /api/v1/shop/products?updated_since=
• GET /api/v1/shop/products/{external_id}
• DELETE /api/v1/shop/products/{external_id} — imisa imveliso okwexeshana
• GET /api/v1/shop/imports/{id} — ingxelo yeqela

Iifayile nemijelo

Iimveliso ezifanayo zingathunyelwa nge-CSV, Excel, XML okanye JSON ukusuka kwiVenkile yam, Ngenisa. Iikholamu:

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

Amaxabiso amaninzi ahlulwe ngomgca othe nkqo (|). Business: iBwatoo iphinda ifunde umjelo wakho okude rhoqo emva kweeyure ezi-6.

Imida

Pro: izinto ezili-100 ezenziwayo ngosuku nezingama-20 ngeyure. Business: ezi-2 000 ngosuku nezingama-300 ngeyure. Ngaphezu kwezingama-50 ezenziwe kwiyure enye, iintengiso ezintsha zijongwa liqela.

Ii-webhook (Business)

Iziganeko: message.received, offer.received, offer.accepted, stock.out, listing.paused. Umbhalo wemiyalezo awuze uthunyelwe. Qinisekisa umsayino ngaphambi kokusebenza ngento ethunyelweyo:

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 ngekhowudi ye-2xx. Ukuba kuyasilela, iBwatoo izama kwakhona amaxesha ama-5, ngexesha lokulinda elikhulayo.