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,那是胸卡凭证。同一邮箱再次报名会得到 200 和 "created": false,返回已有的那条报名:重复只被确认,绝不重复占位。
6

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

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

7 —— 扫码签到

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

​
你刚刚验证了什么

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

​
相关页面

端点参考

剩下的一切:兑换码、加购、捆绑、订单、错误、限流。

票种

容量、候补、审批模式与可见性的完整解释。