diff --git a/docs/superpowers/specs/2026-07-02-channel-state-api-design.md b/docs/superpowers/specs/2026-07-02-channel-state-api-design.md index 606200f9d..d21fb9ace 100644 --- a/docs/superpowers/specs/2026-07-02-channel-state-api-design.md +++ b/docs/superpowers/specs/2026-07-02-channel-state-api-design.md @@ -6,7 +6,7 @@ ## Context -The ChicoryTV Channels prototype needs runtime channel state for the **On-air** filter, live row treatment, and **Now playing** lane. The existing `GET /api/channels` endpoint returns static channel configuration and should stay cheap. Runtime state changes with wall-clock time and active streaming sessions, so it belongs in a separate pollable endpoint. +The ChicoryTV Channels prototype needs runtime channel state for the **On-air** filter, live row treatment, and **Now playing** lane. The existing `GET /api/v1/channels` endpoint returns static channel configuration and should stay cheap. Runtime state changes with wall-clock time and active streaming sessions, so it belongs in a separate pollable endpoint. ErsatzTV has two distinct concepts: @@ -20,7 +20,7 @@ The API should expose both concepts separately rather than blending them into on Add a batched endpoint: ```http -GET /api/channels/state +GET /api/v1/channels/state ``` Response: @@ -48,7 +48,7 @@ Response: Fields: -- `channelId`: channel database id for joining with `GET /api/channels` rows. +- `channelId`: channel database id for joining with `GET /api/v1/channels` rows. - `channelNumber`: stable display/routing number, also useful for active session checks. - `onAir`: `true` when the channel has an active segmenter-backed or direct stream session. - `nowPlaying`: current scheduled `PlayoutItem` by wall-clock, or `null`. @@ -120,7 +120,7 @@ the endpoint contract. Controller tests should verify: -- `GET /api/channels/state` routes through MediatR and returns `200 OK`. +- `GET /api/v1/channels/state` routes through MediatR and returns `200 OK`. - The endpoint advertises a `List` response. Application handler tests should verify: