អានទិន្នន័យរបស់អ្នក
ពីប្រព័ន្ធផ្ទាល់ខ្លួនរបស់អ្នក។
API អានតែប៉ុណ្ណោះសម្រាប់ផលិតផល និងការកុម្ម៉ង់ផ្ទាល់ខ្លួនរបស់អ្នក ដែលការពារដោយកូនសោ API ដែលអ្នកបង្កើតក្នុងកម្មវិធី KopasAI។ មិនមាន SDK ត្រូវដំឡើងទេ៖ កម្មវិធីអតិថិជន HTTP ណាក៏អាចប្រើបាន។
ឯកសារយោង API
/open/me
បង្ហាញថាកូនសោជារបស់អាជីវកម្មណា និងមានវិសាលភាពសិទ្ធិអ្វីខ្លះ។ ដំណើរការជាមួយកូនសោត្រឹមត្រូវណាមួយ។
/open/products
ផលិតផល និងស្តុក៖ ឈ្មោះ SKU ប្រភេទ ឯកតា តម្លៃ ស្តុក និងស្តុកអប្បបរមា។ ត្រូវការវិសាលភាពសិទ្ធិ products:read។
/open/orders
ការកុម្ម៉ង់ជាមួយបណ្តាញ ស្ថានភាព ស្ថានភាពការទូទាត់ ចំនួនទឹកប្រាក់ និងចំនួនទំនិញ។ លេខទូរស័ព្ទ អាសយដ្ឋាន និងកំណត់ចំណាំរបស់អតិថិជន មិនដែលត្រូវបានដាក់បញ្ចូលទេ។ ត្រូវការវិសាលភាពសិទ្ធិ orders:read។
សរសេរ / webhook
មិនទាន់មានទេ៖ API មិនអាចបង្កើត ឬផ្លាស់ប្តូរទិន្នន័យបានទេ ហើយវាមិនផ្ញើ webhook ទេ។
curl https://api.amcoreai.com/api/v1/open/products?limit=20 \
-H "Authorization: Bearer kop_sk_..."
# {"data":[{"id":"...","name":"...","price":15000,"stock":12,...}],
# "meta":{"amountUnit":"IDR_MAJOR","truncated":false,"returned":20}}
លក្ខណៈបច្ចេកទេស
| ប៉ារ៉ាម៉ែត្រ | តម្លៃ |
|---|---|
| URL មូលដ្ឋាន | https://api.amcoreai.com/api/v1 |
| ការផ្ទៀងផ្ទាត់ភាពត្រឹមត្រូវ | Authorization: Bearer kop_sk_... |
| ទំហំទំព័រ | limit ពី 1 ដល់ 100 លំនាំដើម 50 |
| ចំនួនទឹកប្រាក់ | រូពីគត់ (IDR_MAJOR)៖ 15000 មានន័យថា Rp 15,000 |
| ដែនកំណត់អត្រា | 100 សំណើក្នុង 15 នាទីក្នុងមួយអាសយដ្ឋាន IP |
ការដោះស្រាយកំហុស
| កូដ | អត្ថន័យ |
|---|---|
400 | limit មិនមែនជាចំនួនគត់ពី 1 ដល់ 100 ទេ |
401 | កូនសោ API បាត់ ខុស ឬត្រូវបានដកហូត |
403 | កូនសោមិនមានវិសាលភាពសិទ្ធិដែលចំណុចបញ្ចប់នេះត្រូវការទេ |
429 | សំណើច្រើនពេក សូមរង់ចាំ ហើយព្យាយាមម្តងទៀត |
អ្វីដែលអ្នកទទួលបានត្រឡប់មកវិញ
រាល់ការឆ្លើយតបគឺជា JSON ដែលមានពីរផ្នែក៖ data ផ្ទុកធាតុ ហើយ meta ប្រាប់អ្នកពីរបៀបអានពួកវា។
- •
meta.amountUnit- តែងតែជាIDR_MAJORដូច្នេះអ្នកមិនចាំបាច់ទាយឯកតាទេ - •
meta.truncated-trueនៅពេលមានធាតុច្រើនជាងlimitរបស់អ្នក - •
meta.customerFieldsOmitted- លើការកុម្ម៉ង់៖ ទិន្នន័យផ្ទាល់ខ្លួនរបស់អតិថិជនត្រូវបានលុបចេញដោយចេតនា
ឧបករណ៍ & ជំនួយ។
កម្មវិធីភ្ញៀវ HTTP ណាមួយក៏បាន
cURL, fetch, Python requests៖ API គឺជា HTTPS ធម្មតាជាមួយកូនសោ Bearer។
កូនសោក្នុងកម្មវិធី
បង្កើត ដាក់ឈ្មោះ និងដកហូតកូនសោនៅក្នុងម៉ូឌុល API សម្រាប់អ្នកអភិវឌ្ឍន៍ នៃកម្មវិធី KopasAI។
SDK ផ្លូវការ
ឆាប់ៗនេះ។ រហូតដល់ពេលនោះ សូមប្រើឧទាហរណ៍ HTTP នៅលើទំព័រនេះ។