1. 指定日の展示情報を取得する
GET /api/museums/northlight/displays?date=2026-10-27&lang=en
開始画面、作品一覧、作品番号検索、フロアマップ、過去の訪問から開く作品一覧、来館日の変更プレビューでは、現在または過去の指定日に展示されていた作品を同じ形式で取得する必要がある。作品番号検索はオフラインでも使うため、一覧全体をまとめて取得する。
公開した展示構成の版は変更しないため、指定日の作品配置は確定している。一方、画像を表示できるかどうかはリクエスト時点で決まる。一度に展示する作品は数十点なので、レスポンスは大きくならない。
日付を指定するエンドポイントを一つ設ける。dateで展示構成を選び、画像の掲載可否はリクエスト時点で判定する。キャッシュは可能だが、含まれる画像のshownUntilのうち最も早い期限を超えて保持しない。
レスポンス形式
{
"date": "2026-10-27",
"floors": [{ "level": 2, "name": "Second floor", "short": "2" }],
"displays": [
{
"type": "exhibition",
"id": "under-changing-skies",
"title": { "text": "Under Changing Skies", "lang": "en" },
"from": "2026-09-12",
"to": "2027-01-10",
"rooms": [
{
"room": 1, "section": "dawn", "sectionName": "Dawn", "level": 2,
"works": [
{
"workId": "w_monet_1897",
"labelNumber": "105",
"title": { "text": "Morning on the Seine near Giverny", "lang": "en" },
"artist": "Claude Monet",
"image": { "state": "shown", "thumbnail": "https://…", "shownUntil": "2027-01-10T23:00:00Z" }
}
]
}
]
},
{ "type": "collection", "id": "prints-and-drawings", "rooms": [] }
]
}現在の展示情報を取得した後、各作品の詳細(2)と軽量画像をバックグラウンドで読み込む。オフラインで利用できるのは読み込みが完了したものだけ。音声や過去の訪問日の展示は先読みしない。
image.stateはshownまたはnot_shown。not_shownの場合はreasonにcopyright、loan_period_ended、artist_wishのいずれかが入り、画面はその理由に応じた文言を表示する。
作品番号の検索は端末側でこのレスポンスを使って行う。オフラインでも動作するので、検索専用のエンドポイントは設けない。
展示構成の版(Display version)は、企画展またはコレクション展示について、ある期間の作品、展示室への割り当て、作品番号、展示順序を記録する。
各展示室のデータでは、roomは物理的な展示室番号、sectionはテーマ別セクションの識別子、sectionNameはその表示名、levelは階の数値を表す。階のデータにあるnameは階の名称を表す。




