የBwatoo ማስመጫ API

ካታሎግዎን ከካሽ ማሽንዎ፣ ከመስመር ላይ ሱቅዎ ወይም ከአስተዳደር ሶፍትዌርዎ ወደ Bwatoo ሱቅዎ ይላኩ።

የAPI ሰነድ (OpenAPI)

ማረጋገጫ

በ«የእኔ ሱቅ»፣ «የAPI ቁልፎች» ውስጥ ቁልፍ ይፍጠሩ። በAuthorization ራስጌ ውስጥ ይላኩት። የሙከራ ቁልፍ (bw_test_…) ምንም ሳያትም መላኪያዎችዎን አረጋግጦ ሪፖርቱን ይመልሳል።

Authorization: Bearer bw_live_…

ምርቶችን ላክ

በአንድ ጥያቄ ቢበዛ 100 ምርቶች። ምርት ይፈጠራል፣ ወይም አስቀድሞ የሚታወቅ external_id ካለው ይሻሻላል።

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

• ምድቡ እና ባህሪያቱ በድረ-ገጹ ላይ ማስታወቂያ ሲያስገቡ ያሉትን ተመሳሳይ ሕጎች ይከተላሉ፤ የአንድ ምድብ ባህሪያት ዝርዝር በGET /api/v1/categories//attributes ይገኛል።
• ገንዘቡ የሱቁ አገር ገንዘብ መሆን አለበት። በጽሑፎቹ ውስጥ ምንም ስልክ ቁጥር ወይም ኢሜይል አይፈቀድም።
• ፎቶዎቹ ይፋዊ https አድራሻዎች ናቸው፤ Bwatoo ያወርዳቸዋል፣ ይፈትሻቸዋል፣ መጠናቸውንም ያስተካክላል።
• full_feed፦ በመላኪያው ውስጥ የሌሉ የሱቁ ምርቶች ለአፍታ ይቆማሉ፣ በፍጹም አይሰረዙም።
• ክምችት እና ዓይነቶች፦ Business ዕቅድ።
• ከውጭ አገር ቅድመ ትዕዛዝ (Pro እና Business)፦ ships_from (የISO አገር ኮድ፣ ለምሳሌ CN)፣ delivery_days_min እና delivery_days_max (ቀናት፣ ቢበዛ 120)። ምርቱ ከሌላ አገር በሚላክበት ጊዜ ከፍተኛው ጊዜ ግዴታ ነው። Bwatoo «የተላከው ከ፦ ቻይና · ከ45 እስከ 60 ቀ» ያሳያል፣ የአካባቢ አድራሾቹንም አያቀርብም።

እያንዳንዱ ምርት ውጤት ይቀበላል፦ created፣ updated፣ unchanged፣ pending (በቡድኑ መረጋገጥ) ወይም ምክንያቱን የያዘ rejected።

ሌሎች መንገዶች

• GET /api/v1/shop/products?updated_since=
• GET /api/v1/shop/products/{external_id}
• DELETE /api/v1/shop/products/{external_id} — ምርቱን ለአፍታ ያቆማል
• GET /api/v1/shop/imports/{id} — የአንድ ጥቅል ሪፖርት

ፋይሎች እና ምግቦች

ተመሳሳይ ምርቶች ከ«የእኔ ሱቅ»፣ «አስመጣ» በCSV፣ Excel፣ XML ወይም JSON ሊላኩ ይችላሉ። ዓምዶች፦

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

ብዙ እሴቶች በቋሚ መስመር (|) ይለያሉ። Business፦ Bwatoo የርቀት ምግብዎን በየ6 ሰዓቱ እንደገና ያነባል።

ኮታዎች

Pro፦ በቀን 100 እና በሰዓት 20 ፈጠራዎች። Business፦ በቀን 2 000 እና በሰዓት 300። በአንድ ሰዓት ውስጥ ከ50 ፈጠራዎች በላይ ሲሆን አዳዲስ ማስታወቂያዎች በቡድኑ ይረጋገጣሉ።

Webhooks (Business)

ክስተቶች፦ message.received፣ offer.received፣ offer.accepted፣ stock.out፣ listing.paused። የመልእክቶቹ ጽሑፍ በፍጹም አይላክም። መላኪያን ከማስተናገድዎ በፊት ፊርማውን ያረጋግጡ፦

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

በ2xx ኮድ ይመልሱ። ካልተሳካ Bwatoo እየጨመረ በሚሄድ የጊዜ ልዩነት 5 ጊዜ እንደገና ይሞክራል።