门票 API
让其他应用的服务器读取我们的活动,并为付费活动售票。
门票 API 让其他应用的服务器读取我们的活动,并为付费活动售票。通过它售出的门票会进入活动的参会者名单,在入口像其他门票一样扫码入场;订单带有买家邮箱时,门票还会出现在买家在官网上的「我的门票」中。订单也可以要求我们把门票通过邮件发给买家。
这是管理员级别的 API,不面向普通用户。
密钥看到的活动与核心成员在管理后台看到的一样,包括未发布的活动。因此密钥只发给我们自己的系统和我们信任的合作方服务器。
API 返回官网自身读取的全部内容,筛选交给调用方。它的活动包括官网的两类活动:未归档的和已归档的,各自带有官网原有的字段。
能做什么
| 端点 | 权限范围 | 作用 |
|---|---|---|
GET /v1/events | events:read | 列出所有活动,包括已归档的 |
GET /v1/events/{eventId} | events:read | 获取单个活动,例如在收款前再确认一次 |
POST /v1/events/{eventId}/orders | tickets:write | 订单付款后签发其门票 |
GET /v1/events/{eventId}/orders/{orderId} | tickets:read | 获取订单,以及每张门票是否已使用 |
票价保存在销售方的应用中,因为活动本身不存储价格。