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 调用会触发它。
相关页面
端点参考
兑换码、加购、捆绑、订单、错误、限流。
票种
容量、候补、审批模式与可见性。