Event（活动）

Event 是活动主资源。它负责描述活动自身的稳定属性；列表、详情、排行需要的展示字段，应通过读取模型聚合得到。

本页采用单页结构说明 Event 相关模型：

模型	用途	数据性质
`Event`	活动主资源。	Core 模型
`EventCard`	活动列表、附近活动和排行榜中的活动摘要。	读取模型
`EventCardAroundPage`	活动列表双向分页读取结果。	读取模型
`EventProfile`	活动详情页初始资料。	读取模型

模型定义

Event `data` payload

Event 只保存活动本身，核心模型主属性。

Field	Type	supported	Description
`id`	string	✓	由 `key` 生成的稳定公开 ID；客户端应视为 opaque。
`key`	string	✓	全局唯一稳定 key，用于过滤和跨域引用。
`type`	string	✓	活动类型，取值见 `Event.type`。
`title`	string	✓	活动标题。
`subtitle`	string	✓	活动副标题；无值时返回空字符串。
`status`	string	✓	Core 状态，例如 `draft`、`published`、`archived`、`cancelled`。
`officialUrl`	string	✓	官方页面 URL；无值时返回空字符串。
`sourceCheckedAt`	string	✓	来源最近校验时间；无值时返回空字符串。
`organizerName`	string	✓	主办方展示名；在 Organization Core 出现前先作为文本字段，无值时返回空字符串。
`createdAt`	string	✓	资源创建时间。
`updatedAt`	string	✓	资源更新时间。

Event.type

Value	Description
`live`	现场演出。
`fan_meeting`	粉丝见面会。
`release_event`	发售活动、发售纪念活动或特典会。
`stage_play`	舞台剧及其他舞台活动。
`festival`	综合展会、音乐节或联合活动。
`broadcast`	线上配信、播出或网络节目。
`exhibition`	展览活动。
`talk`	Talk、座谈或谈话活动。
`others`	其他活动类型。

EventCard

EventCard 是面向列表和引用场景的读取模型。它以 Event 为基础，聚合展示所需的分类、日程、地点和参与者信息。

Field	Type	Description
`event`	`Event`	活动主资源字段。
`classification.projects`	object[]	项目信息，由 session 级参演记录的 `projectKey` 显式聚合得到；包含 `imageUrl`。
`classification.groups`	object[]	团体信息，由 session 级参演记录的 `groupKey` 显式聚合得到；包含 `imageColor` 和 `imageUrl`。
`participants.headline`	object[]	主演展示对象；来自 headline 关系，只负责展示，不参与分类归属；包含 `imageUrl`。
`location.venues`	object[]	场馆摘要列表，由场次地点去重聚合得到。
`location.venues[].area`	string	场馆所在区域；无值时返回空字符串。
`location.venues[].city`	string	场馆所在城市；无值时返回空字符串。
`schedule.firstStartAt`	string	首场开始时间，由 EventSession 聚合得到；无值时返回空字符串。
`schedule.lastStartAt`	string	末场开始时间，由 EventSession 聚合得到；无值时返回空字符串。
`schedule.nextStartAt`	string	下一场开始时间，由 EventSession 和当前时间派生；无值时返回空字符串。
`timeline.eventPhase`	string	活动整体阶段，由 session / timeline 与当前时间派生。
`timeline.sessionPhase`	string	场次进行阶段，由 session 与当前时间派生。
`timeline.next`	object	下一条 timeline item；无值时返回空对象字段的零值。

EventCardAroundPage

EventCardAroundPage 是活动列表的双向读取模型。它以 anchorAt 为时间锚点，一次返回锚点前、锚点中和锚点后的活动卡片，并为前后两个方向分别提供 cursor。

Field	Type	Description
`data.before`	`EventCard[]`	锚点前的活动卡片。
`data.current`	`EventCard[]`	锚点时刻正在进行或覆盖锚点的活动卡片。
`data.after`	`EventCard[]`	锚点后的活动卡片。
`meta.anchorAt`	string	本次分页使用的时间锚点。
`meta.before`	object	向锚点前继续加载的 cursor meta。
`meta.after`	object	向锚点后继续加载的 cursor meta。

direction=around 返回 before、current、after 三段；direction=before 或 direction=after 只返回对应方向的新一页。cursor 绑定筛选条件、方向和 anchorAt，客户端不能跨筛选条件复用。

EventCard 的分类归属只使用 session 级参演记录里的显式 projectKey / groupKey。event_session_headlines 只影响 headline 展示；character_groups、project_groups、casts 这类长期 Core 关系不用于反推活动分类。

EventProfile

EventProfile 是活动详情页的初始读取模型。它可以复用 EventCard 的摘要信息，并返回活动级票种和场次摘要；与具体场次绑定的地点和出演通过 EventSessionProfile 读取。

Field	Type	Description
`card`	`EventCard`	活动摘要。
`ticketTypes`	object[]	活动票种摘要。
`ticketTypes[].faceValue`	number	票面价格；无值时返回 `0`。
`schedule.sessions`	`EventSession[]`	活动场次摘要列表。

Payload 示例

Event

{
  "id": "event_mygo_9th",
  "key": "mygo-9th",
  "type": "live",
  "title": "MyGO!!!!!「つなぎ目の向こうに」",
  "subtitle": "MyGO!!!!! 9th LIVE「つなぎ目の向こうに」",
  "status": "published",
  "officialUrl": "https://bang-dream.com/events/mygo_9th/",
  "sourceCheckedAt": "2026-05-20T10:00:00+09:00",
  "organizerName": "株式会社ブシロードミュージック",
  "createdAt": "2026-05-20T10:00:00+09:00",
  "updatedAt": "2026-05-20T10:00:00+09:00"
}

EventCard

{
  "event": {
    "id": "event_mygo_9th",
    "key": "mygo-9th",
    "type": "live",
    "title": "MyGO!!!!!「つなぎ目の向こうに」",
    "subtitle": "MyGO!!!!! 9th LIVE「つなぎ目の向こうに」",
    "status": "published",
    "officialUrl": "https://bang-dream.com/events/mygo_9th/",
    "sourceCheckedAt": "2026-05-20T10:00:00+09:00",
    "organizerName": "株式会社ブシロードミュージック",
    "createdAt": "2026-05-20T10:00:00+09:00",
    "updatedAt": "2026-05-20T10:00:00+09:00"
  },
  "classification": {
    "projects": [
      {
        "id": "project:bandori",
        "key": "bandori",
        "name": "BanG Dream! Girls Band Party!",
        "imageUrl": "/assets/core/projects/bandori/logo.webp"
      }
    ],
    "groups": [
      {
        "id": "group:mygo",
        "key": "mygo",
        "name": "MyGO!!!!!",
        "imageColor": "#3388BB",
        "imageUrl": "/assets/core/groups/mygo/logo.webp"
      }
    ]
  },
  "participants": {
    "headline": [
      {
        "key": "mygo",
        "name": "MyGO!!!!!",
        "kind": "group",
        "imageColor": "#3388BB",
        "imageUrl": "/assets/core/groups/mygo/logo.webp"
      }
    ]
  },
  "location": {
    "venues": [
      {
        "key": "tokyo_garden_theater",
        "name": "Tokyo Garden Theater",
        "area": "有明",
        "city": "Tokyo"
      }
    ]
  },
  "schedule": {
    "firstStartAt": "2026-09-12T18:00:00+09:00",
    "lastStartAt": "2026-09-13T17:00:00+09:00",
    "nextStartAt": "2026-09-12T18:00:00+09:00"
  },
  "timeline": {
    "eventPhase": "upcoming",
    "sessionPhase": "pre_live",
    "next": {
      "id": "event_timeline_mygo_9th_general_sale",
      "key": "general-sale",
      "eventKey": "mygo-9th",
      "title": "一般発売",
      "description": "",
      "startsAt": "2026-08-10T12:00:00+09:00",
      "endsAt": "",
      "allDay": false,
      "sourceUrl": "https://bang-dream.com/events/mygo_9th/",
      "displayOrder": 30,
      "createdAt": "2026-05-20T10:00:00+09:00",
      "updatedAt": "2026-05-20T10:00:00+09:00"
    }
  }
}

EventProfile

{
  "card": {
    "event": {
      "id": "event_mygo_9th",
      "key": "mygo-9th",
      "type": "live",
      "title": "MyGO!!!!!「つなぎ目の向こうに」",
      "subtitle": "MyGO!!!!! 9th LIVE「つなぎ目の向こうに」",
      "status": "published",
      "officialUrl": "https://bang-dream.com/events/mygo_9th/",
      "sourceCheckedAt": "2026-05-20T10:00:00+09:00",
      "organizerName": "株式会社ブシロードミュージック",
      "createdAt": "2026-05-20T10:00:00+09:00",
      "updatedAt": "2026-05-20T10:00:00+09:00"
    },
    "classification": {
      "projects": [
        {
          "id": "project:bandori",
          "key": "bandori",
          "name": "BanG Dream! Girls Band Party!",
          "imageUrl": "/assets/core/projects/bandori/logo.webp"
        }
      ],
      "groups": [
        {
          "id": "group:mygo",
          "key": "mygo",
          "name": "MyGO!!!!!",
          "imageColor": "#3388BB",
          "imageUrl": "/assets/core/groups/mygo/logo.webp"
        }
      ]
    },
    "participants": {
      "headline": [
        {
          "key": "mygo",
          "name": "MyGO!!!!!",
          "kind": "group",
          "imageColor": "#3388BB",
          "imageUrl": "/assets/core/groups/mygo/logo.webp"
        }
      ]
    },
    "location": {
      "venues": [
        {
          "key": "tokyo_garden_theater",
          "name": "Tokyo Garden Theater",
          "area": "有明",
          "city": "Tokyo"
        }
      ]
    },
    "schedule": {
      "firstStartAt": "2026-09-12T18:00:00+09:00",
      "lastStartAt": "2026-09-13T17:00:00+09:00",
      "nextStartAt": "2026-09-12T18:00:00+09:00"
    },
    "timeline": {
      "eventPhase": "upcoming",
      "sessionPhase": "pre_live",
      "next": {
        "id": "event_timeline_mygo_9th_general_sale",
        "key": "general-sale",
        "eventKey": "mygo-9th",
        "title": "一般発売",
        "description": "",
        "startsAt": "2026-08-10T12:00:00+09:00",
        "endsAt": "",
        "allDay": false,
        "sourceUrl": "https://bang-dream.com/events/mygo_9th/",
        "displayOrder": 30,
        "createdAt": "2026-05-20T10:00:00+09:00",
        "updatedAt": "2026-05-20T10:00:00+09:00"
      }
    }
  },
  "ticketTypes": [
    {
      "name": "一般指定席",
      "faceValue": 9900,
      "currency": "JPY"
    },
    {
      "name": "一般指定席(特製グッズ付き)",
      "faceValue": 15400,
      "currency": "JPY"
    },
    {
      "name": "プレミアムシート(特製グッズ付き)",
      "faceValue": 22000,
      "currency": "JPY"
    }
  ],
  "schedule": {
    "sessions": [
      {
        "id": "event_session_mygo_9th_day1",
        "key": "day1",
        "eventKey": "mygo-9th",
        "name": "DAY 1",
        "openAt": "2026-09-12T16:00:00+09:00",
        "startAt": "2026-09-12T18:00:00+09:00",
        "createdAt": "2026-05-20T10:00:00+09:00",
        "updatedAt": "2026-05-20T10:00:00+09:00"
      },
      {
        "id": "event_session_mygo_9th_day2",
        "key": "day2",
        "eventKey": "mygo-9th",
        "name": "DAY 2",
        "openAt": "2026-09-13T15:00:00+09:00",
        "startAt": "2026-09-13T17:00:00+09:00",
        "createdAt": "2026-05-20T10:00:00+09:00",
        "updatedAt": "2026-05-20T10:00:00+09:00"
      }
    ]
  }
}

EventCardAroundPage

{
  "data": {
    "before": [],
    "current": [],
    "after": [
      {
        "event": {
          "id": "event_mygo_9th",
          "key": "mygo-9th",
          "type": "live",
          "title": "MyGO!!!!!「つなぎ目の向こうに」",
          "subtitle": "MyGO!!!!! 9th LIVE「つなぎ目の向こうに」",
          "status": "published",
          "officialUrl": "https://bang-dream.com/events/mygo_9th/",
          "sourceCheckedAt": "2026-05-20T10:00:00+09:00",
          "organizerName": "株式会社ブシロードミュージック",
          "createdAt": "2026-05-20T10:00:00+09:00",
          "updatedAt": "2026-05-20T10:00:00+09:00"
        },
        "classification": {
          "projects": [
            {
              "id": "project:bandori",
              "key": "bandori",
              "name": "BanG Dream! Girls Band Party!",
              "imageUrl": "/assets/core/projects/bandori/logo.webp"
            }
          ],
          "groups": [
            {
              "id": "group:mygo",
              "key": "mygo",
              "name": "MyGO!!!!!",
              "imageColor": "#3388BB",
              "imageUrl": "/assets/core/groups/mygo/logo.webp"
            }
          ]
        },
        "participants": {
          "headline": [
            {
              "key": "mygo",
              "name": "MyGO!!!!!",
              "kind": "group",
              "imageColor": "#3388BB",
              "imageUrl": "/assets/core/groups/mygo/logo.webp"
            }
          ]
        },
        "location": {
          "venues": [
            {
              "key": "tokyo_garden_theater",
              "name": "Tokyo Garden Theater",
              "area": "有明",
              "city": "Tokyo"
            }
          ]
        },
        "schedule": {
          "firstStartAt": "2026-09-12T18:00:00+09:00",
          "lastStartAt": "2026-09-13T17:00:00+09:00",
          "nextStartAt": "2026-09-12T18:00:00+09:00"
        },
        "timeline": {
          "eventPhase": "upcoming",
          "sessionPhase": "pre_live",
          "next": {
            "id": "",
            "key": "",
            "eventKey": "",
            "title": "",
            "description": "",
            "startsAt": "",
            "endsAt": "",
            "allDay": false,
            "sourceUrl": "",
            "displayOrder": 0,
            "createdAt": "",
            "updatedAt": ""
          }
        }
      }
    ]
  },
  "meta": {
    "anchorAt": "2026-06-01T10:00:00+09:00",
    "before": {
      "limit": 30,
      "nextCursor": "",
      "hasMore": false
    },
    "after": {
      "limit": 30,
      "nextCursor": "opaque-cursor",
      "hasMore": true
    }
  }
}

HTTP 路由

公开 OpenAPI 规范是路由契约的事实来源。本节只说明 Event 相关资源的语义边界。

Method	Path	Response	Description
`GET`	`/api/v1/events`	`Event[]`	只返回 Event 模型字段。
`GET`	`/api/v1/events/{key}`	`Event`	返回单个 Event。
`GET`	`/api/v1/events/{eventKey}/sessions`	`EventSession[]`	返回活动场次摘要列表。
`GET`	`/api/v1/events/{eventKey}/sessions/{sessionKey}/profile`	`EventSessionProfile`	返回单个场次详情读取模型。
`GET`	`/api/v1/event-cards`	`EventCardAroundPage`	返回支持双向加载的活动列表读取模型。
`GET`	`/api/v1/event-profiles/{eventKey}`	`EventProfile`	返回活动详情读取模型。

/api/v1/events 不返回页面卡片字段；需要页面展示时使用 EventCard 或 EventProfile。

Event（活动）

模型定义

Event data payload

Event.type

EventCard

EventCardAroundPage

EventProfile

Payload 示例

Event

EventCard

EventProfile

EventCardAroundPage

HTTP 路由

Event `data` payload