如何创建和使用 API 令牌

API 令牌可让其他系统连接到您的 TicketingHub 账户。您必须拥有管理员访问权限才能管理 API 令牌。

API 令牌可以用于什么？

• 将 TicketingHub 数据发送到报告软件或数据仓库。
• 允许自定义合作伙伴平台读取产品和价格。
• 构建可检查实时可用性的服务器端预订流程。

API 令牌不会创建内置的 Google 表格连接。请参阅如何导出 TicketingHub 数据并连接其他工具，了解如何在 CSV 导出、Zapier、Webhook 和 API 访问之间进行选择。

启用 API 访问

1. 前往 设置 → 功能。
2. 开启 API 访问权限。

这是一个自助设置。启用后，API 令牌会显示在“设置”中。

创建令牌

1. 前往 设置 → API 令牌。
2. 选择 生成 API 令牌。
3. 输入一个能够标识令牌使用系统的名称。
4. 对于供应商管理，请选择 Supplier API (V2)；对于可用性和预订，请选择 Widget API；对于连接使用 OCTO 标准的系统，请选择 OCTO API。
5. 如果您选择了 Supplier API (V2) 或 OCTO API，并且集成只需要查看数据，则可以选择 只读。此选项不适用于 Widget API 令牌。
6. 如有需要，添加到期日期，然后生成令牌。
7. 立即复制令牌并妥善安全地保存。完整令牌只会显示一次。

使用令牌

在每个 API 请求的 Authorization 标头中发送令牌：

Authorization: Bearer YOUR_TOKEN

仅在安全的服务器端系统中使用 API 令牌。请勿将令牌放入网站代码、电子邮件、聊天消息或共享文档中。

撤销令牌

前往 设置 → API 令牌，然后选择令牌旁边的 撤销。撤销会立即生效，因此连接的系统将停止运行，直到其使用替代令牌。

为每个集成创建单独的令牌，仅授予其所需的访问权限，并撤销不再使用的令牌。对于基于事件的更新，您也可以考虑使用 Webhook 或 Zapier 集成。