API ɗin shigo da kaya na Bwatoo

Aika kundin kayanku zuwa shagonku na Bwatoo daga na'urar kasuwancinku, shagonku na kan layi ko manhajar gudanarwarku.

Tantancewa

Ƙirƙiri makulli a Shagona, Makullan API. Aika shi a cikin kan saƙon Authorization. Makullin gwaji (bw_test_…) yana tantance abin da kuka aika kuma ya dawo da rahoto ba tare da wallafa komai ba.

Authorization: Bearer bw_live_…

Aika kayayyaki

Kayayyaki 100 a mafi yawa a kowace buƙata. Ana ƙirƙirar kaya, ko a sabunta shi idan yana da external_id da aka riga aka sani.

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}

Rukuni da siffofi suna bin dokoki iri ɗaya da saka talla a shafin: GET /api/v1/categories//attributes yana ba da jerin siffofin wani rukuni.
Dole ne kuɗin ya zama na ƙasar shagon. Kada a saka lambar waya ko imel a cikin rubutun.
Hotuna adiresoshin https ne na jama'a; Bwatoo tana sauke su, ta duba su kuma ta gyara girmansu.
full_feed: ana dakatar da kayan shagon da ba sa cikin abin da aka aika, ba a taɓa goge su.
Kaya a ajiya da nau'o'i: tayin Business.
Oda kafin zuwa daga ƙasashen waje (Pro da Business): ships_from (lambar ƙasa ta ISO, misali CN), delivery_days_min da delivery_days_max (kwanaki, 120 a mafi yawa). Mafi tsawon lokaci wajibi ne da zarar kayan zai taso daga wata ƙasa. Bwatoo tana nuna « An aiko daga: Sin · kwana 45 zuwa 60 » kuma ba ta ba da masu kai kayanta na gida.

Kowane kaya yana samun sakamako: created, updated, unchanged, pending (ƙungiya na dubawa) ko rejected tare da dalili.

Sauran hanyoyi

GET /api/v1/shop/products?updated_since=
GET /api/v1/shop/products/{external_id}
DELETE /api/v1/shop/products/{external_id} — yana dakatar da kayan
GET /api/v1/shop/imports/{id} — rahoton rukunin kaya

Fayiloli da feed

Za a iya aika kayayyaki iri ɗaya ta CSV, Excel, XML ko JSON daga Shagona, Shigo da. Ginshiƙai:

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

Ƙima da yawa an raba su da layi a tsaye (|). Business: Bwatoo tana sake karanta feed ɗinku na nesa duk bayan awa 6.

Iyakoki

Pro: ƙirƙira 100 a rana da 20 a awa. Business: 2 000 a rana da 300 a awa. Bayan ƙirƙira 50 a cikin awa ɗaya, sabbin tallace-tallace suna bi ta binciken ƙungiya.

Webhooks (Business)

Abubuwan da suka faru: message.received, offer.received, offer.accepted, stock.out, listing.paused. Ba a taɓa aika rubutun saƙonni. Ku duba sa hannun kafin sarrafa abin da aka aiko:

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

Ku amsa da lambar 2xx. Idan an gaza, Bwatoo tana sake gwadawa sau 5, tare da jinkiri mai ƙaruwa.