Bagian 8 dari 12

Integrasi & API

Integrasikan Buqq dengan POS atau alat kustom Anda melalui REST API eksternal.

Bagian Integrasi menyediakan REST API eksternal untuk membangun integrasi kustom dengan POS atau alat lainnya. Akses dari Dasbor → Integrasi.

Referensi API lengkap — skema endpoint, detail autentikasi, dan contoh — tersedia di buqq.online/api-docs.
Peringatan reservasi Telegram diatur di Pengaturan → Notifikasi. Lihat bagian Pengaturan panduan ini untuk langkah-langkah pengaturan.

Merchant ID#

Merchant ID Anda adalah pengidentifikasi unik untuk akun Anda di platform Buqq. Ini ditampilkan di halaman Integrasi dan diperlukan saat menghubungi dukungan atau menggunakan endpoint API tertentu.

Kunci API#

API eksternal Buqq memungkinkan Anda membaca ketersediaan, membuat reservasi, dan memperbarui status reservasi dari sistem Anda sendiri. Akses API memerlukan kunci API yang terkait dengan akun merchant Anda.

Membuat kunci

  1. Di Dasbor → Integrasi, gulir ke "Kunci API".
  2. Klik "Buat kunci API".
  3. Salin kunci dan simpan di variabel lingkungan atau pengelola rahasia Anda.
Perlakukan kunci API Anda seperti kata sandi — jangan bagikan atau masukkan ke version control. Jika Anda mencurigai kunci telah dibobol, cabut segera dan buat yang baru.

Menampilkan kunci saat ini

Jika Anda perlu mengambil kunci yang ada, klik Tampilkan — kunci lengkap ditampilkan sehingga Anda dapat menyalinnya kembali.

Merotasi kunci

Merotasi mengganti kunci Anda saat ini dengan yang baru. Kunci lama langsung tidak berlaku. Perbarui integrasi yang menggunakan kunci lama sebelum merotasi.

Mencabut kunci

Mencabut menghapus kunci saat ini tanpa menerbitkan yang baru. Panggilan API akan gagal hingga Anda membuat kunci baru. Gunakan cabut jika Anda mencurigai kunci telah dibobol.

Cuplikan cURL#

Halaman Integrasi menampilkan cuplikan cURL siap pakai untuk operasi API yang paling umum. Ganti YOUR_API_KEY dengan kunci Anda yang sebenarnya untuk langsung menguji.

CONTOH — Periksa ketersediaan

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

Catatan POS#

Jika Anda menghubungkan Buqq ke sistem point-of-sale, API eksternal mendukung pembacaan reservasi terkonfirmasi hari ini dan pembaruan status (misalnya menandai reservasi sebagai check-in atau dibatalkan) dari POS Anda. Konsultasikan dokumentasi vendor POS Anda untuk langkah integrasi spesifik mereka, dan lihat dokumentasi API untuk detail endpoint.

GET /api/external/v1/availability
Mengembalikan slot yang tersedia untuk tanggal dan jumlah rombongan tertentu.
GET /api/external/v1/bookings
Menampilkan daftar reservasi untuk restoran Anda. Filter berdasarkan tanggal.
POST /api/external/v1/bookings
Membuat reservasi baru secara programatis.
PATCH /api/external/v1/bookings/{id}/status
Memperbarui status reservasi (confirmed, checked_in, cancelled, no_show).