የTwendex Platform API
ሎጅስቲክስን ወደ መተግበሪያዎ ይገንቡ። Twendexን የሚያንቀሳቅሰው ተመሳሳይ ሞተር — ጭነቶች፣ ዋጋዎች፣ ክትትል፣ webhooks — በREST API ይገኛል።
ምን መገንባት ይችላሉ
የTwendex Platform API በአፍሪካ በሺዎች የሚቆጠሩ ንግዶች የሚጠቀሙበትን ተመሳሳይ የሎጅስቲክስ ሞተር ለመተግበሪያዎ ይሰጣል። ጭነቶችን ይፍጠሩ፣ ወቅታዊ ዋጋ ያግኙ፣ አጓጓዦችን ይመድቡ፣ ማድረሻዎችን ይከታተሉ፣ የwebhook ክስተቶችን ይቀበሉ — ሁሉም በአንድ የተሰየመ REST API።
ጭነቶችን መፍጠርና ማስተዳደር
ጭነቶችን በፕሮግራም ይፍጠሩ፣ ዋጋ ይጠይቁ፣ ጨረታ ይቀበሉ፣ አጓጓዦችን ይመድቡ — ከTwendex ገጽ ጋር ተመሳሳይ አሠራር።
ወቅታዊ Webhooks
ለእያንዳንዱ የጭነት ሁኔታ ለውጥ የተፈረሙና እንደገና የሚሞከሩ የwebhook ክስተቶችን ይቀበሉ፦ ተፈጥሯል፣ ዋጋ ተሰጥቷል፣ ተመድቧል፣ በመንገድ ላይ፣ ደርሷል።
በወሰን የተጠበቀ መዳረሻ
የAPI ቁልፎች ለሀብቶችዎ ብቻ የተወሰኑ ናቸው። በመለያዎች መካከል መዳረስ ተከልክሏል። የአጠቃቀም ገደቦች በእያንዳንዱ ደረጃ ፍትሐዊ አጠቃቀምን ያረጋግጣሉ።
በራስ ማስተዳደር
የAPI ቁልፎችን ከዳሽቦርድዎ ያውጡ፣ ይቀይሩ፣ ይሰርዙ። የwebhook መድረሻዎችን ይመዝግቡ። አጠቃቀምን ይከታተሉ — በእጅ ማጽደቅ አያስፈልግም።
ማረጋገጫ
# All API requests require an API key
curl -H "X-API-Key: twx_live_xxxxxxxxxxxx" \
https://api.twendex.com/api/v1/platform/shipments
# Or use Bearer token
curl -H "Authorization: Bearer twx_live_xxxxxxxxxxxx" \
https://api.twendex.com/api/v1/platform/shipmentsመሠረታዊ URL፦ https://api.twendex.com/api/v1
ፈጣን ጅምር
የAPI ቁልፍ ያግኙ
ወደ Twendex መለያዎ ይግቡ፣ ወደ የገንቢዎች ዳሽቦርድ ይሂዱና የsandbox API ቁልፍ ይፍጠሩ። የቁልፉ ሚስጥር አንድ ጊዜ ብቻ ይታያል — ወዲያውኑ ይቅዱት።
የመጀመሪያ ጭነትዎን ይፍጠሩ
የAPI ቁልፍዎን በX-API-Key header ውስጥ አድርገው ወደ /api/v1/platform/shipments የPOST ጥያቄ ይላኩ። የማንሻ፣ የማድረሻና የዕቃ ዝርዝሮችን በጥያቄው ውስጥ ያካትቱ።
ዋጋ ያግኙና አጓጓዥ ይመድቡ
የአጓጓዦችን ጨረታ ለማየት GET /api/v1/platform/shipments/{id}/quotes ይመልከቱ። ጨረታን ለመቀበል ወደ የአጓጓዥ መመደቢያ መድረሻ ይላኩ።
ይከታተሉና webhooks ይቀበሉ
ወቅታዊ ቦታ ለማወቅ GET /api/v1/platform/tracking/{shipmentId} ይጠቀሙ። ለእያንዳንዱ የሁኔታ ለውጥ እስከ ማድረስ ማረጋገጫ ድረስ ክስተቶችን በራስ-ሰር ለመቀበል የwebhook መድረሻ ይመዝግቡ።
Sandbox / የሙከራ ሁኔታ
የSandbox ቁልፎች እውነተኛ አጓጓዦችን፣ ገንዘብን ወይም ማሰማራትን ሳይነኩ ሙሉውን የAPI አሠራር እንዲሞክሩ ያስችሉዎታል። የሙከራ ጭነቶች ከቀጥታ መረጃ ተለይተዋል።
- ከገንቢዎች ዳሽቦርድዎ የsandbox ቁልፍ ይፍጠሩ (ሲፈጥሩ አካባቢውን ወደ 'sandbox' ያድርጉ)።
- ሁሉም የsandbox ጭነቶች በሙከራ ሁኔታ ይቆያሉ — እውነተኛ አጓጓዥ አይሰማራም፣ እውነተኛ ክፍያ አይከናወንም።
- እንደ ቀጥታ አገልግሎት ተመሳሳይ መድረሻዎችንና አሠራርን ይጠቀሙ። ለመጀመር ሲዘጋጁ ወደ ቀጥታ ቁልፍ ይቀይሩ።
መስተጋብራዊ የAPI ሰነድ
እያንዳንዱን መድረሻ ይመርምሩ፣ የጥያቄና የምላሽ አወቃቀርን ይመልከቱ፣ በቀጥታ ከአሳሽዎ በSwagger ሰነዳችን ጥሪዎችን ይሞክሩ።
የAPI ሰነድ ክፈትመለያ አለዎት? ቁልፎችዎንና webhooks ከዳሽቦርድ ያስተዳድሩ።
ወደ ገንቢዎች ዳሽቦርድ ይሂዱ