រំលងទៅមាតិកា

អ្នកអភិវឌ្ឍន៍

បង្កើតលើ Anantak Commerce

ភ្ជាប់ហាងរបស់អ្នកទៅប្រព័ន្ធផ្ទាល់ខ្លួន។ អាន និងកែប្រែផលិតផល ការបញ្ជាទិញ ការប្រមូលផ្តុំ និងច្រើនទៀត តាមរយៈ REST API ដោយប្រើកូនសោដែលកំណត់សម្រាប់ហាងតែមួយ និងមានតែសិទ្ធិដែលអ្នកត្រូវការ។

terminal
curl https://api.anantak.co/api/v1/shops/$SHOP_ID/products \
  -H "Authorization: Bearer anantak_…"

{
  "data": [
    { "id": "…", "title": "Ceramic vase", … }
  ],
  "pagination": { … }
}

ឯកសារយោង API ពេញលេញនឹងមកដល់ឆាប់ៗ។ ក្នុងពេលនេះ សូមផ្ញើអ៊ីមែលមកយើងអំពីអ្វីដែលអ្នកចង់បង្កើត ហើយយើងនឹងជួយអ្នកចាប់ផ្តើម។

ការផ្ទៀងផ្ទាត់

សំណើនីមួយៗត្រូវមានកូនសោ API របស់ហាងជា Bearer token។ កូនសោចាប់ផ្តើមដោយ anantak_ ហើយជារបស់ហាងតែមួយប៉ុណ្ណោះ៖ កូនសោរបស់ហាងមួយមិនអាចអានទិន្នន័យរបស់ហាងផ្សេងបានទេ។ កូនសោត្រូវបានចេញដោយ Velon Innovations តាមការស្នើសុំរបស់អ្នក សូមប្រាប់យើងពីសិទ្ធិដែលអ្នកត្រូវការ។

  • ផ្ញើកូនសោនៅក្នុង header Authorization៖ Bearer anantak_…
  • កូនសោនីមួយៗមានតែសិទ្ធិដែលបានផ្តល់ឱ្យប៉ុណ្ណោះ ពីបញ្ជីខាងក្រោម។
  • កូនសោក៏អាចមានដែនកំណត់អត្រាផ្ទាល់ខ្លួនផងដែរ។
  • រក្សាកូនសោនៅលើម៉ាស៊ីនមេរបស់អ្នក។ កុំដាក់វានៅក្នុងគេហទំព័រ ឬកម្មវិធីទូរសព្ទ។

សំណើ និងការឆ្លើយតប

ចំណុចបញ្ចប់ទាំងអស់របស់ហាងស្ថិតនៅក្រោម /api/v1/shops/{shopId}/ នៅលើម៉ាស៊ីន API ហើយប្រើ JSON។ ហាងនៅក្នុង URL ត្រូវតែជាហាងរបស់កូនសោ។

https://api.anantak.co/api/v1/shops/{shopId}/…

មួយចំនួននៃអ្វីដែលមាន

  • GET/productsបង្ហាញបញ្ជីផលិតផលរបស់អ្នក។
  • POST/productsបង្កើតផលិតផល។
  • GET/ordersបង្ហាញបញ្ជីការបញ្ជាទិញ។
  • POST/ordersបង្កើតការបញ្ជាទិញ។
  • GET/collectionsបង្ហាញបញ្ជីការប្រមូលផ្តុំ។
  • GET/customersបង្ហាញបញ្ជីអតិថិជន។

សិទ្ធិ

ផ្តល់ឱ្យកូនសោតែអ្វីដែលការភ្ជាប់របស់អ្នកប្រើប៉ុណ្ណោះ។ នេះជាសិទ្ធិដែលកូនសោអាចមាន៖

  • product:view

    អានផលិតផល។

  • product:manage

    បង្កើត កែប្រែ និងលុបផលិតផល។

  • order:view

    អានការបញ្ជាទិញ និងអតិថិជន។

  • order:manage

    បង្កើត និងកែប្រែការបញ្ជាទិញ។

  • order:fulfill

    រៀបចំការបញ្ជាទិញ។

  • collection:manage

    បង្កើត និងកែប្រែការប្រមូលផ្តុំ។

  • discount:view

    អានការបញ្ចុះតម្លៃ។

  • discount:manage

    បង្កើត និងកែប្រែការបញ្ចុះតម្លៃ។

  • inventory:view

    អានកម្រិតស្តុក។

  • inventory:adjust

    កែតម្រូវកម្រិតស្តុក។

  • location:view

    អានទីតាំងរបស់អ្នក។

  • analytics:view

    អានតួលេខផ្ទាំងគ្រប់គ្រង។

តួនាទីក្រុមការងារ

មនុស្សនៅក្នុងហាងរបស់អ្នកក៏មានតួនាទីដែរ ហើយសិទ្ធិដូចគ្នានៅពីក្រោយពួកគេ។ Owner និង admin អាចធ្វើអ្វីៗគ្រប់យ៉ាងនៅក្នុងហាង រួមទាំងរបាយការណ៍ និងការគ្រប់គ្រងក្រុម។ Manager គ្រប់គ្រងផលិតផល ការបញ្ជាទិញ ការបញ្ចុះតម្លៃ និងការដឹកជញ្ជូន។ Staff រៀបចំការបញ្ជាទិញ ប្រើ POS និងបើកបរដឹកជញ្ជូន។

កំហុស

កំហុសត្រលប់មកវិញជាមួយស្ថានភាព HTTP និងតួ JSON។ កូនសោដែលបាត់ ឬមិនត្រឹមត្រូវទទួលបាន 401 កូនសោដែលគ្មានសិទ្ធិចាំបាច់ទទួលបាន 403។ នៅពេលដល់ដែនកំណត់នៃគម្រោងរបស់អ្នក ឧទាហរណ៍ ចំនួនផលិតផល API ឆ្លើយតប 403 ជាមួយកូដ PLAN_LIMIT_EXCEEDED និងដែនកំណត់ដែលអ្នកបានដល់។

ស្នើសុំកូនសោ API

ឯកសារយោង API ពេញលេញនឹងមកដល់ឆាប់ៗ។ ក្នុងពេលនេះ សូមផ្ញើអ៊ីមែលមកយើងអំពីអ្វីដែលអ្នកចង់បង្កើត ហើយយើងនឹងជួយអ្នកចាប់ផ្តើម។

[email protected]