RegioPLAY Public API v1 stabilní

Verzovaná datová vrstva pro klientské aplikace — Apple TV, Samsung Tizen, LG webOS, Android TV, web, iOS, Android. Veškerá data pochází ze stejné administrace a databáze jako web RegioPLAY (create once, publish everywhere).

Základní URL

Produkce (plánovaná):  https://api.regioplay.cz/v1
Technická (aktuální):  https://api.regioplay.cz/api/public/v1

Hlavičky

X-RegioPlay-Platform: web | samsung | lg | appletv | androidtv | ios | android   (výchozí: web)
X-RegioPlay-App-Version: 1.0.0

Chyby

{ "error": { "code": "CHANNEL_NOT_FOUND", "message": "Channel not found" } }

HTTP statusy: 200, 400, 404, 429, 500, 503. Časy jsou ISO 8601 s timezone. Obrázky jsou absolutní HTTPS URL.

Endpointy

GET/healthHealth check API
GET/configKonfigurace aplikace dle platformy (feature flagy, heartbeat, maintenance)
GET/homeHomepage řízená administrací (hero + sekce)
GET/channelsSeznam kanálů (category, region, type, featured, limit, offset)
GET/channels/:idDetail kanálu + stream model (HLS URL / YouTube)
GET/channels/:id/epgEPG kanálu — now/next + program (date, from, to)
GET/epg/nowAktuální pořady všech živých kanálů
GET/videosVOD katalog (channel, show, category, region, featured, order, limit, offset)
GET/videos/:idDetail videa + stream
GET/categoriesSeznam kategorií
GET/categories/:idKategorie s kanály a videi
GET/regionsSeznam regionů
GET/regions/:idRegion s kanály a videi
GET/search?q=Vyhledávání (kanály, videa, pořady, kategorie, regiony)
GET/featuredRedakčně propagovaný obsah
GET/openapi.jsonOpenAPI 3.0 specifikace

Apple TV — acceptance flow

GET /v1/config → GET /v1/home → GET /v1/channels → GET /v1/channels/{slug} → stream.url (HLS) → AVPlayer