# 面向开发者的 TicketingHub。

嵌入预订小部件、用 Widget API 构建您自己的结账流程，或通过 Supplier API 和 Webhook 连接您的系统，所有端点都在[开发者文档](https://api.ticketinghub.com/api-docs/index.html)中。

- [预订小部件](https://www.ticketinghub.com/zh/developers#widget)
- [Widget API](https://www.ticketinghub.com/zh/developers#widget-api)
- [Supplier API 与 Webhook](https://www.ticketinghub.com/zh/developers#apis-webhooks)
- [上线步骤](https://www.ticketinghub.com/zh/developers#launch)

## 在您的网站上嵌入预订小部件。

这就是客人用来预订的实时小部件：添加一张门票试试看。

- **嵌入小部件。**用一小段代码将它添加到您的网站，并在上线前进行测试。

- **使用您自己的颜色。**托管式结账页面，使用您的品牌颜色，放在您自己的网站上。

- **通过 TicketingHub 收款。**可用名额、付款和确认都由 TicketingHub 处理。

了解如何用预订小部件进行[在线销售](https://www.ticketinghub.com/zh/product/sell#online)。

[在 Immersive Gamebox 网站上查看小部件的实际效果](https://www.immersivegamebox.com/en-US)

实时 – 试试

## 用 Widget API 构建您自己的结账流程。

您的结账页面通过 API 获取可用名额，并在付款后确认预订。

- **获取可用名额。**获取客人可以预订的日期和时间。

- **创建购物车。**将门票和客人信息添加到订单中。

- **凭据保存在您的服务器上。**请求通过您的服务器发出，您的集成会在确认订单前完成收款。

查看 [Widget API 参考](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Widget%20API%20V1)。

*插图：您自己的结账页面通过 API 获取可用时段，客人选择时间，预订通过 API 确认。*

## 通过 Supplier API 和 Webhook 连接您的系统。

每笔新预订都会发送到您的工具，并以签名 Webhook 的形式发送到您自己的系统。

- **管理您的账户。**Supplier API 让您从自己的系统管理产品、预订和运营。

- **接收签名 Webhook。**预订被确认、取消或更新时，您会收到通知。

- **验证与重试。**请在服务器上验证每个签名；文档说明了负载内容和重试机制。

查看 [Supplier API 参考](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Supplier%20API%20V2)和 [Webhook](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Webhooks)。

*插图：一笔新的在线预订依次发送到您连接的每个工具。*

## 从第一个请求到上线。

1. **告诉我们您在构建什么。**分享您的预订流程、想要连接的系统以及所需的数据。

2. **确认访问权限。**与我们的团队确认您的集成所需的 API 访问权限和设置。

3. **构建并测试。**使用 API 参考探索端点、检查请求格式并测试您的预订流程。

4. **准备上线。**检查付款处理、错误响应以及您的集成使用的 Webhook。

## 常见问题。

### 你们提供公共的自助API密钥吗？

我们在与您简短交流您的使用案例后启用 API 访问，以便我们可以为您指引到正确的界面和环境。预约演示以开始。

### Widget API 和供应商 API 之间有什么区别？

Widget API 帮助您围绕我们的可嵌入结账构建服务器驱动的流程。供应商 API 用于以编程方式管理产品、预订和操作。许多团队同时使用这两者。

### 如何在生产前进行测试？

我们提供适合环境的凭证和文档，以便您可以安全地验证集成。您在TicketingHub的联系人将在您构建时确认使用哪些端点。

### Webhook 如何进行身份验证？

Webhook通过HTTPS传递，并包含您应在服务器上验证的签名。将签名密钥视为任何其他凭证一样处理——仅在服务器端存储。

### 我可以获得实施帮助吗？

是的。我们的团队在入职培训、特殊情况和上线审核中支持合作伙伴，特别是在您连接支付、访问控制或自定义报告时。