门票 API

让其他应用的服务器读取我们的活动,并为付费活动售票。

门票 API 让其他应用的服务器读取我们的活动,并为付费活动售票。通过它售出的门票会进入活动的参会者名单,在入口像其他门票一样扫码入场;订单带有买家邮箱时,门票还会出现在买家在官网上的「我的门票」中。订单也可以要求我们把门票通过邮件发给买家。

这是管理员级别的 API,不面向普通用户。

密钥看到的活动与核心成员在管理后台看到的一样,包括未发布的活动。因此密钥只发给我们自己的系统和我们信任的合作方服务器。

API 返回官网自身读取的全部内容,筛选交给调用方。它的活动包括官网的两类活动:未归档的和已归档的,各自带有官网原有的字段。

能做什么

端点权限范围作用
GET /v1/eventsevents:read列出所有活动,包括已归档的
GET /v1/events/{eventId}events:read获取单个活动,例如在收款前再确认一次
POST /v1/events/{eventId}/orderstickets:write订单付款后签发其门票
GET /v1/events/{eventId}/orders/{orderId}tickets:read获取订单,以及每张门票是否已使用

票价保存在销售方的应用中,因为活动本身不存储价格。

接下来

代码位于 functions/src/functions/api.ts。

本页目录