ទំព័រទី 8 នៃ 12

Integrations & API

ភ្ជាប់ Buqq ទៅកាន់ប្រព័ន្ធលក់ (POS) របស់អ្នក ដោយប្រើប្រាស់ REST API

ផ្នែក Integrations ផ្តល់ REST API ខាងក្រៅ សម្រាប់បង្កើតការរួមបញ្ចូល ផ្ទាល់ខ្លួនជាមួយ POS ឬឧបករណ៍ផ្សេងទៀតរបស់អ្នក។ ចូលប្រើបានពី Dashboard → Integrations។

ឯកសារយោង API ពេញ — schemas endpoint ព័ត៌មានលំអិតការផ្ទៀងផ្ទាត់ និង ឧទាហរណ៍ — មានជា buqq.online/api-docs។
ការជូនដំណឹងការកក់ Telegram ត្រូវបានដំឡើងក្នុង Settings → Notifications។ សូមមើល​ផ្នែក Settings នៃ Guide នេះ សម្រាប់ជំហានការដំឡើង។

Merchant ID#

Merchant ID របស់អ្នកគឺជាអត្តសញ្ញាណតែមួយគត់សម្រាប់គណនីរបស់អ្នក ក្នុងវេទិកា Buqq។ វាត្រូវបានបង្ហាញនៅទំព័រ Integrations ហើយ ត្រូវការ នៅពេលទំនាក់ទំនង support ឬប្រើ endpoint API ខ្លះ។

API keys#

API ខាងក្រៅ Buqq អនុញ្ញាតឱ្យអ្នកអានភាពអាចរកបាន បង្កើតការកក់ និងធ្វើបច្ចុប្បន្នភាពស្ថានភាពការកក់ ពីប្រព័ន្ធផ្ទាល់ខ្លួនរបស់អ្នក។ ការចូលប្រើ API ត្រូវការ API key ដែលភ្ជាប់ជាមួយគណនីពាណិជ្ជករ របស់អ្នក។

ការបង្កើត key

  1. ក្នុង Dashboard → Integrations រំកិលទៅ "API Keys"។
  2. ចុច "Generate API key"។
  3. ចម្លង key ហើយរក្សាទុកក្នុងអថេរបរិស្ថានរបស់អ្នក ឬ secrets manager។
ចាត់ទុក API key របស់អ្នកដូចជាពាក្យសំងាត់ — កុំចែករំលែកវា ឬ commit វា ទៅ version control។ ប្រសិនបើអ្នកសង្ស័យថា key ត្រូវបានលេចធ្លាយ ដកហូតវាភ្លាមៗ ហើយបង្កើតថ្មី។

ការបង្ហាញ key បច្ចុប្បន្ន

ប្រសិនបើអ្នកត្រូវការទទួល key ដែលមានស្រាប់ ចុច Reveal — key ពេញត្រូវបានបង្ហាញ ដូច្នេះអ្នកអាចចម្លងវាម្ដងទៀត។

ការប្តូរ key

ការប្តូរជំនួស key បច្ចុប្បន្នរបស់អ្នកដោយ key ថ្មី។ Key ចាស់ត្រូវបាន ធ្វើឱ្យមិនត្រឹមត្រូវភ្លាមៗ។ ធ្វើបច្ចុប្បន្នភាពការរួមបញ្ចូលណាមួយ ដែលប្រើ key ចាស់ មុននឹងប្តូរ។

ការដកហូត key

ការដកហូតលប់ key បច្ចុប្បន្ន ដោយមិនចេញ key ថ្មី។ API calls នឹងបរាជ័យ រហូតដល់អ្នកបង្កើត key ថ្មី។ ប្រើការដកហូត ប្រសិនបើអ្នកសង្ស័យថា key ត្រូវបានលេចធ្លាយ។

cURL snippets#

ទំព័រ Integrations បង្ហាញ cURL snippets ដែលត្រៀមប្រើ សម្រាប់ operations API ទូទៅបំផុត។ ជំនួស YOUR_API_KEY ជាមួយ key ពិតប្រាកដរបស់អ្នក ដើម្បីសាកល្បងភ្លាមៗ។

ឧទាហរណ៍ — ពិនិត្យភាពអាចរកបាន

curl https://buqq.online/api/external/v1/availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G -d "date=2025-08-15" -d "party_size=2"

ចំណាំ POS#

ប្រសិនបើអ្នកកំពុងភ្ជាប់ Buqq ទៅប្រព័ន្ធ POS API ខាងក្រៅ គាំទ្រការអានការកក់ដែលបានបញ្ជាក់ថ្ងៃនេះ និងការធ្វើបច្ចុប្បន្នភាព ស្ថានភាព (ឧ. សម្គាល់ការកក់ជា checked-in ឬ cancelled) ពី POS របស់អ្នក។ ពិគ្រោះជាមួយឯកសារ POS vendor របស់អ្នក សម្រាប់ជំហានការរួមបញ្ចូលជាក់លាក់ ហើយពិនិត្យ ឯកសារ API សម្រាប់ព័ត៌មានលំអិត endpoint។

GET /api/external/v1/availability
ត្រឡប់ slot ដែលអាចរកបាន សម្រាប់កាលបរិច្ឆេទ និងទំហំក្រុមដែលបានផ្ដល់ជូន។
GET /api/external/v1/bookings
រាយបញ្ជីការកក់សម្រាប់ភោជនីយដ្ឋានរបស់អ្នក។ ច្រោះដោយកាលបរិច្ឆេទ។
POST /api/external/v1/bookings
បង្កើតការកក់ថ្មីដោយប្រើ programming។
PATCH /api/external/v1/bookings/{id}/status
ធ្វើបច្ចុប្បន្នភាពស្ថានភាពការកក់ (confirmed, checked_in, cancelled, no_show)។