Cách tạo và sử dụng token API

Token API cho phép một hệ thống khác kết nối với tài khoản TicketingHub của bạn. Bạn phải có quyền quản trị viên để quản lý các token này.

Tôi có thể sử dụng token API để làm gì?

Gửi dữ liệu TicketingHub đến phần mềm báo cáo hoặc kho dữ liệu.
Cho phép nền tảng đối tác tùy chỉnh đọc sản phẩm và giá.
Xây dựng quy trình đặt chỗ phía máy chủ có khả năng kiểm tra tình trạng còn chỗ theo thời gian thực.

Token API không tạo kết nối Google Sheets tích hợp sẵn. Hãy xem Cách xuất dữ liệu TicketingHub và kết nối các công cụ khác để lựa chọn giữa việc xuất CSV, Zapier, webhook và quyền truy cập API.

Bật quyền truy cập API

Truy cập Cài đặt → Tính năng.
Bật Quyền truy cập API.

Đây là một cài đặt tự phục vụ. Sau khi bật, Token API sẽ xuất hiện trong phần Cài đặt.

Tạo token

Truy cập Cài đặt → Token API.
Chọn Tạo token API.
Nhập tên giúp xác định hệ thống sử dụng token.
Chọn Supplier API (V2) để quản lý nhà cung cấp, Widget API để kiểm tra tình trạng còn chỗ và đặt chỗ, hoặc OCTO API để kết nối các hệ thống hỗ trợ tiêu chuẩn OCTO.
Nếu chọn Supplier API (V2) hoặc OCTO API, bạn có thể chọn Chỉ đọc khi tích hợp chỉ cần xem dữ liệu. Tùy chọn này không áp dụng cho token Widget API.
Nếu cần, hãy thêm ngày hết hạn rồi tạo token.
Sao chép token ngay lập tức và lưu trữ an toàn. Toàn bộ token chỉ được hiển thị một lần.

Sử dụng token

Gửi token trong tiêu đề Authorization của mỗi yêu cầu API:

Authorization: Bearer YOUR_TOKEN

Chỉ sử dụng token API trong các hệ thống phía máy chủ an toàn. Không đưa token vào mã nguồn website, email, tin nhắn trò chuyện hoặc tài liệu dùng chung.

Thu hồi token

Truy cập Cài đặt → Token API và chọn Thu hồi bên cạnh token. Việc thu hồi có hiệu lực ngay lập tức, vì vậy hệ thống được kết nối sẽ ngừng hoạt động cho đến khi sử dụng token thay thế.

Hãy tạo một token riêng cho mỗi tích hợp, chỉ cấp quyền truy cập cần thiết và thu hồi những token không còn được sử dụng. Đối với các cập nhật dựa trên sự kiện, bạn có thể ưu tiên sử dụng webhook hoặc tích hợp Zapier.