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/…"
}

本页目录