Skip to main content
本教程用 curl 完成整个流程。需要一把密钥(去生成)和 API 主机:
1

1 —— 创建活动

活动以草稿状态创建——发布之前对公众不可见。记下返回的 id。
2

2 —— 创建票种

priceAmount 是活动币种的最小货币单位——CNY 活动里 12000 就是 ¥120.00。填 0(或不填)即免费票。记下返回的 id。
3

3 —— 开售

票种同样以草稿状态创建。开售就是改状态:
4

4 —— 读取剩余票

held 是公开结账中活跃订单占住的名额。这些数字是参考值。真正的校验发生在报名时,读到旧值也不会导致超卖。
5

5 —— 录入报名

201 且 "created": true ——注意返回里的 checkinCode(胸卡凭证)与 passUrl(平台刚刚以邮件送达的托管入场凭证页,打开前会要求输入邮箱)。同一邮箱再次报名会得到 200 和 "created": false,返回已有的那条报名。重复只被确认,绝不重复占位。
6

6 —— 审批(若票种开了审批模式)

在审批模式的票种上,API 录入的报名落在 pending。API 只记录申请,不代表准入决定。要明确地做出决定:
7

7 —— 扫码签到

201 记录到场。同一张胸卡再扫一次得到 200 和 "alreadyCheckedIn": true ——被确认,不是报错。

覆盖范围

  • 草稿优先的生命周期 ——活动和票种在被打开之前不可见,与控制台一致。
  • 容量闸门 ——confirmed 到达 capacity 后,下一次报名收到 412(票种开了候补则落 waitlisted)。
  • 幂等的重复 ——重复报名与重复扫码都以确认代替报错,重试是安全的。
  • 自动化 ——如果这个业务单元配置了「新增参会人」或签到自动化,这些 API 调用会触发它。

相关页面

端点参考

兑换码、加购、捆绑、订单、错误、限流。

票种

容量、候补、审批模式与可见性。