公開API一覧
サイトと同じ公開データを、機械可読な JSON で取得できる読み取り専用 API です。利用に API キーは不要です（GET のみ）。
下記のパスは、このサイトのオリジンに付けて呼び出します。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app
本番では NEXT_PUBLIC_SITE_URL を正しい https URL に設定すると、ここに表示されるベースと JSON 内のリンクが一致します。
一覧は { data, meta }、詳細は { data } です。エラー時は { error: { code, message } }。
レスポンスには CDN 向けのキャッシュヘッダが付きます（一覧・詳細・マスタで秒数が異なります）。
エンドポイント
- エンドポイント一覧（JSON）
GET /api/v1
バージョン情報と各リソースへの絶対 URL が返ります。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1
- 公演一覧
GET /api/v1/performances
公開中またはアーカイブの公演をページングで取得します。
クエリ: page（既定 1）, limit（既定 24、最大 50）, status=published | archived（既定 published）
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/performances
- 公演詳細
GET /api/v1/performances/（ID）
1件の公演。日付・出演・スタッフ・ジャンル・画像などを含みます（published / archived）。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/performances/…
- 劇場一覧
GET /api/v1/theaters
劇場・ホールをページングで取得します。
クエリ: page, limit（最大 50）
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/theaters
- 劇場詳細
GET /api/v1/theaters/（ID）
1件の劇場情報。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/theaters/…
- 劇団一覧
GET /api/v1/companies
掲載中（active）の劇団のみ。サイトの劇団一覧と同じ条件です。
クエリ: page, limit（最大 50）
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/companies
- 劇団詳細
GET /api/v1/companies/（ID）
1件の劇団情報。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/companies/…
- ジャンルマスタ
GET /api/v1/genres
ジャンル一覧（全件、ページングなし）。
https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/genres
curl -sS "https://actors-stage-l1ecp0lh6-himenos-projects-4465adeb.vercel.app/api/v1/performances?limit=5"
常識的なアクセス間隔での利用をお願いします。別ドメインのブラウザから直接 fetch する場合は CORS の設定が必要になることがあります。サーバー側やアプリからの利用を想定しています。