Phần 8 / 12

Tích hợp & API

Tích hợp Buqq với POS hoặc công cụ tùy chỉnh qua API REST bên ngoài.

Phần Tích hợp cung cấp API REST bên ngoài để xây dựng tích hợp tùy chỉnh với hệ thống POS hoặc các công cụ khác. Truy cập từ Bảng điều khiển → Tích hợp.

Tài liệu API đầy đủ — sơ đồ endpoint, chi tiết xác thực và ví dụ — có tại buqq.online/api-docs.
Thông báo đặt chỗ qua Telegram được thiết lập trong Cài đặt → Thông báo. Xem phần Cài đặt của hướng dẫn này để biết các bước thiết lập.

Mã thương nhân#

Mã thương nhân là mã định danh duy nhất cho tài khoản của bạn trên nền tảng Buqq. Nó được hiển thị trên trang Tích hợp và cần thiết khi liên hệ hỗ trợ hoặc sử dụng một số endpoint API nhất định.

Khóa API#

API bên ngoài của Buqq cho phép bạn đọc lịch trống, tạo đặt chỗ và cập nhật trạng thái đặt chỗ từ hệ thống riêng. Truy cập API yêu cầu khóa API liên kết với tài khoản thương nhân.

Tạo khóa

  1. Trong Bảng điều khiển → Tích hợp, cuộn đến "Khóa API".
  2. Nhấp "Tạo khóa API".
  3. Sao chép khóa và lưu trữ trong biến môi trường hoặc trình quản lý bí mật.
Hãy bảo mật khóa API như mật khẩu — không chia sẻ hoặc đưa vào hệ thống quản lý mã nguồn. Nếu bạn nghi ngờ khóa bị lộ, hãy thu hồi ngay và tạo khóa mới.

Hiển thị khóa hiện tại

Nếu bạn cần truy xuất khóa hiện có, nhấp Hiển thị — khóa đầy đủ sẽ được hiển thị để bạn có thể sao chép lại.

Xoay khóa

Xoay khóa sẽ thay thế khóa hiện tại bằng khóa mới. Khóa cũ bị vô hiệu ngay lập tức. Cập nhật tất cả tích hợp đang sử dụng khóa cũ trước khi xoay.

Thu hồi khóa

Thu hồi sẽ xóa khóa hiện tại mà không tạo khóa mới. Các lệnh gọi API sẽ thất bại cho đến khi bạn tạo khóa mới. Sử dụng thu hồi nếu bạn nghi ngờ khóa bị lộ.

Đoạn mã cURL#

Trang Tích hợp hiển thị các đoạn mã cURL sẵn dùng cho các thao tác API phổ biến nhất. Thay thế YOUR_API_KEY bằng khóa thực tế của bạn để kiểm tra ngay.

VÍ DỤ — Kiểm tra lịch trống

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

Ghi chú POS#

Nếu bạn đang kết nối Buqq với hệ thống bán hàng, API bên ngoài hỗ trợ đọc các đặt chỗ đã xác nhận trong ngày và cập nhật trạng thái (ví dụ: đánh dấu đặt chỗ là đã nhận khách hoặc đã hủy) từ POS. Tham khảo tài liệu của nhà cung cấp POS để biết các bước tích hợp cụ thể, và xem tài liệu API để biết chi tiết endpoint.

GET /api/external/v1/availability
Trả về các khung giờ trống cho ngày và số lượng khách nhất định.
GET /api/external/v1/bookings
Liệt kê đặt chỗ cho nhà hàng của bạn. Lọc theo ngày.
POST /api/external/v1/bookings
Tạo đặt chỗ mới theo chương trình.
PATCH /api/external/v1/bookings/{id}/status
Cập nhật trạng thái đặt chỗ (confirmed, checked_in, cancelled, no_show).