Event 对象
官网的两类活动(未归档和已归档)及其字段。
官网有两类活动,用 archived 区分:
- 未归档(
archived: false):即将开始、正在进行,或已结束但尚未归档。门票为这类活动售卖。 - 已归档(
archived: true):活动结束后工作人员会将其归档,它会移到官网的往期活动中。它的 ID 保持不变,所以它的链接和其订单的链接都继续有效。它的门票变为只读。
两类活动共享一部分字段,其余字段不同,与官网存储它们的方式一致。
两类共有的字段
idstring活动 ID。归档后不变。
archivedboolean活动是否已归档。
onSaleboolean现在是否可以为它下单。仅当活动未归档、是付费活动、尚未结束且不待删除(deleteAt 为 null)时为 true。未发布的活动也可以在售,所以向公众展示前还要检查 published。
titlestring英文标题。
titleCnstring中文标题。为 "" 时,官网显示 title。
descriptionstring英文描述,纯文本,可能包含换行。
descriptionCnstring中文描述。为 "" 时,官网显示 description。
locationstring英文地点,例如房间或楼名。
locationCnstring中文地点。
venueIdstring活动场地在官网地图和停车指南中的 ID,没有则为 ""。场地目前还不在 API 中。
publishedboolean公开官网是否显示该活动。未发布的活动是草稿,或是刚归档、工作人员尚未发布到往期活动页面的活动。
paidboolean活动是否有门票。免费活动没有。
deleteAtstring | null如果工作人员申请删除该活动,则为它的预定删除时间。删除会等待 48 小时,期间可以取消。否则为 null。
未归档活动的字段
startAtstring | null活动开始时间。
endAtstring | null活动结束时间。订单在此时截止。
posterstring海报图片的 URL,或 ""。
posterCreditstring海报作者,或 ""。
emailHeaderBgstring门票邮件页眉图片的 URL,或 ""。
buyTicketstring官网「获取门票」按钮的链接,没有则为 ""。
learnMorestring官网「了解更多」按钮的链接,没有则为 ""。
customButtonTextstring官网额外显示的按钮的英文文字。
customButtonTextCnstring该按钮的中文文字。
customButtonLinkstring该按钮的链接,没有额外按钮时为 ""。
已归档活动的字段
datestring活动举行的日期,格式为 YYYY-MM-DD,太平洋时间。
tagIdsstring[]活动在官网上的标签 ID,例如「Workshop」。标签目前还不在 API 中。
iconstring往期活动页面上活动照片的 URL,或 ""。
recapLinkstring回顾文章的 URL,或 ""。
recapLinkCnstring中文回顾文章的 URL,或 ""。
示例
未归档的活动:
{
"id": "k3Xq9VbLm2PzR8TaYw4N",
"archived": false,
"onSale": true,
"title": "Sekai Beyond Con 2026",
"titleCn": "彼世界动漫游戏展 2026",
"description": "Our yearly convention.\nCosplay, vendors and stage shows.",
"descriptionCn": "我们一年一度的漫展。\nCosplay、摊位和舞台表演。",
"location": "HUB Ballroom",
"locationCn": "HUB 宴会厅",
"venueId": "hub",
"published": true,
"paid": true,
"deleteAt": null,
"startAt": "2026-11-14T18:00:00.000Z",
"endAt": "2026-11-15T02:00:00.000Z",
"poster": "https://firebasestorage.googleapis.com/v0/b/…/o/upcoming-events%2F…",
"posterCredit": "Mika",
"emailHeaderBg": "",
"buyTicket": "https://sekaibeyond.com/con",
"learnMore": "",
"customButtonText": "",
"customButtonTextCn": "",
"customButtonLink": ""
}已归档的活动:
{
"id": "aB7cD8eF9gH0iJ1kL2mN",
"archived": true,
"onSale": false,
"title": "Spring Game Night",
"titleCn": "春季游戏之夜",
"description": "Board games and rhythm games.",
"descriptionCn": "桌游和音游。",
"location": "Mary Gates Hall 241",
"locationCn": "Mary Gates Hall 241",
"venueId": "",
"published": true,
"paid": false,
"deleteAt": null,
"date": "2026-04-18",
"tagIds": [
"gameNight"
],
"icon": "https://firebasestorage.googleapis.com/v0/b/…/o/events%2F…",
"recapLink": "",
"recapLinkCn": "https://www.xiaohongshu.com/…"
}