{"openapi":"3.0.3","info":{"title":"RegioPLAY Public API","version":"1.0.0","description":"Veřejné verzované API RegioPLAY pro klientské aplikace (Apple TV, Samsung Tizen, LG webOS, Android TV, web, iOS, Android). Čte data ze stejného backendu jako web RegioPLAY. Verze v1 je stabilní veřejný kontrakt."},"servers":[{"url":"https://api.regioplay.cz/v1","description":"Produkce — veřejná URL pro klientské aplikace"},{"url":"https://api.regioplay.cz/api/public/v1","description":"Interní technická URL (nepoužívat v aplikacích)"}],"tags":[{"name":"System"},{"name":"Config"},{"name":"Home"},{"name":"Channels"},{"name":"EPG"},{"name":"VOD"},{"name":"Taxonomy"},{"name":"Search"}],"paths":{"/health":{"get":{"tags":["System"],"summary":"Health check","operationId":"getHealth","responses":{"200":{"description":"API je v pořádku","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"apiVersion":{"type":"string","example":"1"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/config":{"get":{"tags":["Config"],"summary":"Konfigurace aplikace podle platformy","operationId":"getConfig","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"X-RegioPlay-App-Version","in":"header","required":false,"schema":{"type":"string","example":"1.0.0"},"description":"Verze klientské aplikace (compatibility management, analytika)."}],"responses":{"200":{"description":"Konfigurace platformy","content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","example":"appletv"},"apiVersion":{"type":"string","example":"1"},"minimumAppVersion":{"type":"string","example":"1.0.0"},"latestAppVersion":{"type":"string","example":"1.0.0"},"updateRequired":{"type":"boolean"},"maintenanceMode":{"type":"boolean"},"maintenanceMessage":{"type":"string","nullable":true},"features":{"type":"object","properties":{"liveTv":{"type":"boolean"},"vod":{"type":"boolean"},"epg":{"type":"boolean"},"search":{"type":"boolean"},"login":{"type":"boolean"},"favorites":{"type":"boolean"},"continueWatching":{"type":"boolean"},"radio":{"type":"boolean"}}},"heartbeatInterval":{"type":"integer","example":60}}}}}},"503":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/home":{"get":{"tags":["Home"],"summary":"Homepage řízená administrací","operationId":"getHome","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"Slug regionu pro sekci „Z vašeho regionu“."}],"responses":{"200":{"description":"Hero + seznam sekcí v definovaném pořadí"}}}},"/channels":{"get":{"tags":["Channels"],"summary":"Seznam kanálů","operationId":"listChannels","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"},"description":"Slug regionu"},{"name":"type","in":"query","schema":{"type":"string","enum":["live","vod","live_vod","loop","event","radio"]}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"{ items: Channel[], limit, offset, hasMore }"}}}},"/channels/{id}":{"get":{"tags":["Channels"],"summary":"Detail kanálu včetně streamu","operationId":"getChannel","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Slug nebo UUID kanálu"}],"responses":{"200":{"description":"Detail kanálu se stream modelem"},"404":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/channels/{id}/epg":{"get":{"tags":["EPG"],"summary":"EPG kanálu (now/next + program dne)","operationId":"getChannelEpg","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","schema":{"type":"string","example":"2026-08-23"}},{"name":"from","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"{ channelId, now, next, programs[] }"},"404":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/epg/now":{"get":{"tags":["EPG"],"summary":"Aktuální pořady všech živých kanálů","operationId":"getEpgNow","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."}],"responses":{"200":{"description":"[{ channelId, program }]"}}}},"/videos":{"get":{"tags":["VOD"],"summary":"Seznam VOD videí","operationId":"listVideos","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"channel","in":"query","schema":{"type":"string"},"description":"Slug nebo UUID kanálu"},{"name":"show","in":"query","schema":{"type":"string"},"description":"Slug nebo UUID pořadu"},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"region","in":"query","schema":{"type":"string"}},{"name":"featured","in":"query","schema":{"type":"boolean"}},{"name":"order","in":"query","schema":{"type":"string","enum":["recent","popular","editorial"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":24,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"{ items: Video[], limit, offset, hasMore }"}}}},"/videos/{id}":{"get":{"tags":["VOD"],"summary":"Detail videa","operationId":"getVideo","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Slug nebo UUID videa"}],"responses":{"200":{"description":"Detail videa se stream modelem"},"404":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/categories":{"get":{"tags":["Taxonomy"],"summary":"Seznam kategorií","operationId":"listCategories","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."}],"responses":{"200":{"description":"{ items: Category[] }"}}}},"/categories/{id}":{"get":{"tags":["Taxonomy"],"summary":"Kategorie s kanály a videi","operationId":"getCategory","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Slug kategorie"}],"responses":{"200":{"description":"{ id, name, channels[], videos[] }"},"404":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/regions":{"get":{"tags":["Taxonomy"],"summary":"Seznam regionů","operationId":"listRegions","responses":{"200":{"description":"{ items: Region[] }"}}}},"/regions/{id}":{"get":{"tags":["Taxonomy"],"summary":"Region s kanály a videi","operationId":"getRegion","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Slug nebo UUID regionu"}],"responses":{"200":{"description":"{ id, slug, name, channels[], videos[] }"},"404":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/search":{"get":{"tags":["Search"],"summary":"Fulltextové vyhledávání","operationId":"search","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2}}],"responses":{"200":{"description":"{ channels[], videos[], shows[], categories[], regions[] }"},"400":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}},"429":{"description":"Chyba — jednotný formát","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}}}},"/featured":{"get":{"tags":["Home"],"summary":"Redakčně propagovaný obsah","operationId":"getFeatured","parameters":[{"name":"X-RegioPlay-Platform","in":"header","required":false,"schema":{"type":"string","enum":["web","samsung","lg","appletv","androidtv","ios","android"],"default":"web"},"description":"Platforma klienta. Alternativně query parametr ?platform=."}],"responses":{"200":{"description":"{ items: ContentItem[] }"}}}}},"components":{"schemas":{"Stream":{"type":"object","properties":{"type":{"type":"string","enum":["hls","youtube","progressive","external"]},"url":{"type":"string","format":"uri"},"youtubeId":{"type":"string","nullable":true},"mimeType":{"type":"string","nullable":true,"example":"application/vnd.apple.mpegurl"},"drm":{"type":"object","nullable":true},"startOver":{"type":"boolean"},"catchup":{"type":"boolean"}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}