{"openapi":"3.1.0","info":{"title":"Hentai TV Public Content API","version":"1.0.0","description":"面向網頁、搜尋和智慧代理的公開唯讀內容介面。播放、帳戶、管理和寫入介面不在本規範範圍內。發送 Accept: text/markdown 可取得可引用摘要；公開回應不包含播放直鏈、預覽直鏈或內部資料庫主鍵。"},"servers":[{"url":"https://hentaitv.cc"}],"tags":[{"name":"Videos","description":"影片內容"},{"name":"Content","description":"資訊、專題精選和創作者"},{"name":"Editorial","description":"專題精選與觀看指南"},{"name":"Lists","description":"通過審核的公開片單"},{"name":"Entities","description":"創作者和製作工作室實體"},{"name":"Series","description":"系列、季度和分集事實"},{"name":"Previews","description":"按月份歸檔的真實預告條目"},{"name":"Discovery","description":"搜尋、分類、排行榜、追番週表和標籤"}],"paths":{"/api/v1":{"get":{"operationId":"getApiRoot","tags":["Discovery"],"summary":"讀取公開 API 入口","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"}],"responses":{"200":{"description":"API 入口和機器可讀資源連結","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ApiRoot"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/videos":{"get":{"operationId":"listVideos","tags":["Videos"],"summary":"分頁查詢影片","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"categoryId","in":"query","schema":{"type":"integer","minimum":1}},{"name":"genre","in":"query","schema":{"type":"string","maxLength":200}},{"name":"year","in":"query","schema":{"type":"string","maxLength":20}},{"name":"tags","in":"query","schema":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":40}},"style":"form","explode":true,"description":"多标签组合筛选：每个 tags 参数是一组 OR 值，多组之间 AND；以 - 前缀排除（例如 tags=纯爱,校园 与 tags=-NTR）。"},{"name":"entity","in":"query","schema":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":80}},"style":"form","explode":true,"description":"实体维度筛选：每个 entity 参数是一组 OR 值，多组之间 AND；值形态 <type>:<slug>，type 取 studio/creator 或关系别名 director/actor/writer/composer/producer（关系别名折叠到 creator 实体并带关系过滤）。"},{"name":"original","in":"query","schema":{"type":"string","maxLength":80},"description":"原作维度筛选：按 video_metadata.original_work 模糊匹配（对应 original-author 统称）。"},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"影片分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/VideoPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/videos/{id}":{"get":{"operationId":"getVideo","tags":["Videos"],"summary":"讀取影片詳情","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"影片詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicVideo"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/videos/{id}/info":{"get":{"operationId":"getVideoInfo","tags":["Videos"],"summary":"讀取影片詳情","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"完整视频资料","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicVideoInfo"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/content":{"get":{"operationId":"listContent","tags":["Content"],"summary":"分頁查詢公開內容","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["article","topic","actor","role"],"default":"article"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"內容分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ContentPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/content/{kind}/{id}":{"get":{"operationId":"getContent","tags":["Content"],"summary":"讀取資訊、專題精選或創作者詳情","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["article","topic","actor","role"]}},{"name":"id","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"內容詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicContentDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/editorial":{"get":{"operationId":"listEditorialHubs","tags":["Editorial"],"summary":"分頁查詢專題精選或觀看指南","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"kind","in":"query","required":true,"schema":{"type":"string","enum":["collection","guide"]}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"專題/指南分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/EditorialHubPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/editorial/{kind}/{slug}":{"get":{"operationId":"getEditorialHub","tags":["Editorial"],"summary":"讀取專題精選或觀看指南詳情","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["collection","guide"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"專題/指南詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/EditorialHubDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/lists":{"get":{"operationId":"listPublicLists","tags":["Lists"],"summary":"分頁查詢通過審核的公開片單","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"公開片單分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicListPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/lists/{slug}":{"get":{"operationId":"getPublicList","tags":["Lists"],"summary":"讀取公開片單及收錄作品","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":180}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"公開片單詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicListDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/entities":{"get":{"operationId":"listEntities","tags":["Entities"],"summary":"分頁查詢創作者或工作室","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["creator","studio"]}},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"實體分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/EntityPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/entities/{type}/{slug}":{"get":{"operationId":"getEntity","tags":["Entities"],"summary":"讀取創作者或工作室詳情","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"type","in":"path","required":true,"schema":{"type":"string","enum":["creator","studio"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"實體詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicEntityDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series":{"get":{"operationId":"listSeries","tags":["Series"],"summary":"分頁查詢系列","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"status","in":"query","schema":{"type":"string","enum":["all","ongoing","completed","paused"],"default":"all"}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"系列分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SeriesPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series/{slug}":{"get":{"operationId":"getSeries","tags":["Series"],"summary":"讀取系列及分集事實","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":180}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"系列詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicSeriesDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series/{slug}/season/{season}":{"get":{"operationId":"getSeriesSeason","tags":["Series"],"summary":"讀取系列季度及分集事實","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":180}},{"name":"season","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"系列季度詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicSeriesSeasonDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/series/{slug}/episode/{episode}":{"get":{"operationId":"getSeriesEpisode","tags":["Series"],"summary":"讀取系列分集事實","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"slug","in":"path","required":true,"schema":{"type":"string","maxLength":180}},{"name":"episode","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"系列分集詳情","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PublicSeriesEpisodeDetail"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/previews":{"get":{"operationId":"listPreviews","tags":["Previews"],"summary":"按月份分頁查詢預告歸檔","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"month","in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"預告分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/PreviewPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/tags":{"get":{"operationId":"listTags","tags":["Discovery"],"summary":"分頁查詢公開標籤","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"標籤分頁","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/TagPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/tag-taxonomy":{"get":{"operationId":"getTagTaxonomy","tags":["Discovery"],"summary":"读取标签分类体系","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"}],"responses":{"200":{"description":"标签分类体系","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagTaxonomyEnvelope"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/search":{"get":{"operationId":"searchVideos","tags":["Discovery"],"summary":"搜尋影片","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"頁碼，從 1 開始。"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"description":"每頁數量，最大 50。"},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"搜尋結果","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SearchPage"},"meta":{"$ref":"#/components/schemas/PageMeta"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","tags":["Discovery"],"summary":"讀取分類","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"分類列表","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/CategoryPage"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/rankings":{"get":{"operationId":"getRankings","tags":["Discovery"],"summary":"讀取排行榜","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"mode","in":"query","schema":{"type":"string","enum":["day","week","month","all"],"default":"week"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"排行榜","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/RankingPage"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/schedule/week":{"get":{"operationId":"getScheduleWeek","tags":["Discovery"],"summary":"讀取追番週表","parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["zh-CN","zh-TW","en-US"],"default":"zh-TW"},"description":"返回內容和頁面連結使用的語言。"},{"name":"weekStart","in":"query","schema":{"type":"string","format":"date"}},{"name":"timezone","in":"query","schema":{"type":"string","maxLength":64}},{"name":"categoryId","in":"query","schema":{"type":"integer","minimum":1}},{"name":"Accept","in":"header","schema":{"type":"string","example":"text/markdown"},"description":"發送 text/markdown 可取得適合閱讀和引用的 Markdown。"}],"responses":{"200":{"description":"週表資料","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ScheduleWeek"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"請求參數無效","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"資源不存在","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"請求過於頻繁","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","required":["type","title","status","detail"],"properties":{"type":{"type":"string","format":"uri-reference"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"}}},"PageMeta":{"type":"object","required":["total","page","pageCount","pageSize"],"properties":{"total":{"type":"integer"},"page":{"type":"integer"},"pageCount":{"type":"integer"},"pageSize":{"type":"integer"},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri-reference"},"previous":{"type":"string","format":"uri-reference"},"next":{"type":"string","format":"uri-reference"}},"additionalProperties":false}}},"PublicVideo":{"type":"object","required":["id","title","poster","categoryId","tags","previewAvailable","sourceCount","episodeCount"],"properties":{"id":{"type":"integer","minimum":1,"description":"為相容舊 URL 而保留的公開影片 ID。"},"categoryId":{"type":"integer"},"title":{"type":"string"},"originalTitle":{"type":"string"},"poster":{"type":"string"},"backdrop":{"type":"string"},"year":{"type":"string"},"area":{"type":"string"},"genre":{"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"Localized display labels"},"canonicalTags":{"type":"array","items":{"type":"string"},"description":"Canonical labels used by URLs and filters"},"quality":{"type":"string"},"score":{"type":"number"},"remarks":{"type":"string"},"director":{"type":"string"},"actors":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"previewAvailable":{"type":"boolean"},"sourceCount":{"type":"integer"},"episodeCount":{"type":"integer"},"infoUrl":{"type":"string","format":"uri-reference"},"detailUrl":{"type":"string","format":"uri-reference"},"relatedVideos":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"recommendedVideos":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"series":{"$ref":"#/components/schemas/PublicVideoSeriesReference"},"entityRelations":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideoEntityRelation"}},"playback":{"$ref":"#/components/schemas/PublicPlaybackSummary"}}},"PublicVideoSeriesReference":{"type":"object","required":["slug","title","status","episodeCount"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["ongoing","completed","paused"]},"episodeCount":{"type":"integer","minimum":0},"url":{"type":"string","format":"uri-reference"}}},"PublicVideoEntityRelation":{"type":"object","required":["type","slug","name","role"],"properties":{"type":{"type":"string","enum":["creator","studio"]},"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string"},"image":{"type":"string"}}},"PublicVideoInfo":{"type":"object","required":["video","categoryName","metadata","previews","credits","stats"],"properties":{"video":{"allOf":[{"$ref":"#/components/schemas/PublicVideo"}],"description":"作品基本资料与稳定页面地址；不包含媒体直链。"},"categoryName":{"type":"string"},"metadata":{"$ref":"#/components/schemas/VideoMetadata"},"previews":{"type":"array","items":{"$ref":"#/components/schemas/VideoPreview"}},"credits":{"type":"array","items":{"$ref":"#/components/schemas/VideoCredit"}},"stats":{"$ref":"#/components/schemas/VideoStats"}}},"VideoMetadata":{"type":"object","properties":{"englishTitle":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"ageRating":{"type":"string"},"language":{"type":"string"},"subtitles":{"type":"array","items":{"type":"string"}},"premiereDate":{"type":"string"},"totalDurationMinutes":{"type":"integer","minimum":0},"contentWarnings":{"type":"array","items":{"type":"string"}},"originalWork":{"type":"string"},"writers":{"type":"array","items":{"type":"string"}},"producers":{"type":"array","items":{"type":"string"}},"music":{"type":"string"},"cinematography":{"type":"string"},"editor":{"type":"string"},"distributor":{"type":"string"},"officialWebsite":{"type":"string","format":"uri"},"officialSocial":{"type":"array","items":{"type":"string","format":"uri"}},"watchOrderNote":{"type":"string"},"contentBody":{"type":"string"},"geoSummary":{"type":"string"}}},"VideoPreview":{"type":"object","required":["title","position"],"properties":{"title":{"type":"string"},"thumbnail":{"type":"string"},"durationSeconds":{"type":"integer","minimum":0},"position":{"type":"integer","minimum":1}}},"VideoCredit":{"type":"object","required":["name","role"],"properties":{"name":{"type":"string"},"role":{"type":"string"},"entityType":{"type":"string","enum":["creator","studio"]},"slug":{"type":"string"},"image":{"type":"string"}}},"VideoStats":{"type":"object","required":["playCount","favoriteCount","commentCount","voteUp","voteDown","watchlistCount"],"properties":{"playCount":{"type":"integer"},"favoriteCount":{"type":"integer"},"commentCount":{"type":"integer"},"voteUp":{"type":"integer"},"voteDown":{"type":"integer"},"watchlistCount":{"type":"integer"}}},"PublicPlaybackSummary":{"type":"object","required":["available","sources"],"properties":{"available":{"type":"boolean"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/PublicSourceSummary"}}}},"PublicSourceSummary":{"type":"object","required":["sid","name","episodeCount"],"properties":{"sid":{"type":"integer"},"name":{"type":"string"},"access":{"type":"string","enum":["free","vip"]},"episodeCount":{"type":"integer"},"episodes":{"type":"array","items":{"$ref":"#/components/schemas/PublicEpisodeSummary"}}}},"PublicEpisodeSummary":{"type":"object","required":["nid","title"],"properties":{"nid":{"type":"integer"},"title":{"type":"string"},"thumbnail":{"type":"string"},"releasedAt":{"type":"string","format":"date-time","nullable":true}}},"PublicContent":{"type":"object","required":["id","kind","title","summary","tags"],"properties":{"id":{"type":"integer","minimum":1},"kind":{"type":"string","enum":["article","topic","actor","role"]},"categoryId":{"type":"integer"},"title":{"type":"string"},"image":{"type":"string"},"summary":{"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"Localized display labels"},"canonicalTags":{"type":"array","items":{"type":"string"},"description":"Canonical labels used by URLs and filters"},"author":{"type":"string"},"seoTitle":{"type":"string"},"seoDescription":{"type":"string"},"seoKeywords":{"type":"array","items":{"type":"string"}},"geoSummary":{"type":"string"},"geoFaq":{"type":"array","items":{"$ref":"#/components/schemas/ContentFaqItem"}},"canonicalPath":{"type":"string"},"indexable":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ContentFaqItem":{"type":"object","required":["question","answer"],"properties":{"question":{"type":"string"},"answer":{"type":"string"}}},"PublicContentDetail":{"allOf":[{"$ref":"#/components/schemas/PublicContent"},{"type":"object","required":["body","bodyFormat","bodyHtml","bodyText","embeddedVideos","relatedVideos","toc"],"properties":{"body":{"type":"string"},"bodyFormat":{"type":"string","enum":["markdown","html"]},"bodyHtml":{"type":"string"},"bodyText":{"type":"string"},"embeddedVideos":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"relatedVideos":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"toc":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"level":{"type":"integer"}}}},"navigation":{"type":"object","properties":{"previous":{"$ref":"#/components/schemas/PublicContentNavigation"},"next":{"$ref":"#/components/schemas/PublicContentNavigation"}}}}}]},"PublicContentNavigation":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"title":{"type":"string"},"image":{"type":"string"},"summary":{"type":"string"}}},"Category":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer"},"parentId":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"videoCount":{"type":"integer"}}},"ApiLinks":{"type":"object","additionalProperties":{"type":"string","format":"uri-reference"}},"ApiRoot":{"type":"object","required":["version","links"],"properties":{"version":{"type":"string"},"links":{"$ref":"#/components/schemas/ApiLinks"}}},"ApiEnvelope":{"type":"object","required":["data"],"properties":{"data":{},"meta":{}}},"CategoryPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}},"VideoPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"categories":{"type":"array","items":{"$ref":"#/components/schemas/Category"}},"category":{"$ref":"#/components/schemas/Category","nullable":true}}},"ContentPage":{"type":"object","required":["items","kind"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicContent"}},"kind":{"type":"string"}}},"EditorialHub":{"type":"object","required":["type","slug","title","summary","tags","url","contentUrl"],"properties":{"type":{"type":"string","enum":["collection","guide"]},"slug":{"type":"string"},"title":{"type":"string"},"image":{"type":"string"},"summary":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"author":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri-reference"},"contentUrl":{"type":"string","format":"uri-reference"},"indexable":{"type":"boolean"}}},"EditorialHubPage":{"type":"object","required":["items","kind"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/EditorialHub"}},"kind":{"type":"string","enum":["collection","guide"]}}},"EditorialHubDetail":{"allOf":[{"$ref":"#/components/schemas/EditorialHub"},{"type":"object","required":["content"],"properties":{"content":{"$ref":"#/components/schemas/PublicContent"}}}]},"PublicList":{"type":"object","required":["slug","title","summary","tags","videoCount","url","indexable"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"image":{"type":"string"},"summary":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"author":{"type":"string"},"videoCount":{"type":"integer","minimum":2},"updatedAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri-reference"},"indexable":{"type":"boolean"}}},"PublicListDetail":{"allOf":[{"$ref":"#/components/schemas/PublicList"},{"type":"object","required":["body","bodyFormat","bodyHtml","bodyText","videos"],"properties":{"body":{"type":"string"},"bodyFormat":{"type":"string","enum":["markdown","html"]},"bodyHtml":{"type":"string"},"bodyText":{"type":"string"},"toc":{"type":"array","items":{"type":"object","required":["id","level","text"],"properties":{"id":{"type":"string"},"level":{"type":"integer","enum":[2,3]},"text":{"type":"string"}}}},"geoSummary":{"type":"string"},"geoFaq":{"type":"array","items":{"$ref":"#/components/schemas/ContentFaqItem"}},"videos":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}}}}]},"PublicListPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicList"}}}},"PublicEntity":{"type":"object","required":["type","slug","name","videoCount","indexable","url"],"properties":{"type":{"type":"string","enum":["creator","studio"]},"slug":{"type":"string"},"name":{"type":"string"},"originalName":{"type":"string"},"image":{"type":"string"},"summary":{"type":"string"},"videoCount":{"type":"integer"},"indexable":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri-reference"}}},"PublicEntityDetail":{"allOf":[{"$ref":"#/components/schemas/PublicEntity"},{"type":"object","required":["geoSummary","videos"],"properties":{"geoSummary":{"type":"string"},"videos":{"type":"array","items":{"$ref":"#/components/schemas/PublicEntityVideo"}}}}]},"PublicEntityVideo":{"type":"object","required":["id","title","poster"],"properties":{"id":{"type":"integer"},"title":{"type":"string"},"poster":{"type":"string"},"backdrop":{"type":"string"},"year":{"type":"string"},"genre":{"type":"string"},"score":{"type":"number"},"description":{"type":"string"},"roles":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri-reference"}}},"EntityPage":{"type":"object","required":["items","type"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicEntity"}},"type":{"type":"string","enum":["creator","studio"]}}},"SearchPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}}}},"RankingPage":{"type":"object","required":["items","mode"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"mode":{"type":"string"}}},"ScheduleWeek":{"type":"object","required":["weekStart","weekEnd","timezone","days","unscheduled"],"properties":{"weekStart":{"type":"string","format":"date"},"weekEnd":{"type":"string","format":"date"},"timezone":{"type":"string"},"days":{"type":"array","items":{"type":"object"}},"unscheduled":{"type":"array","items":{"type":"object"}}}},"SeriesEpisode":{"type":"object","required":["episodeNumber","title","infoUrl","playable"],"properties":{"episodeNumber":{"type":"integer","minimum":1},"title":{"type":"string"},"description":{"type":"string"},"durationSeconds":{"type":"integer","minimum":1},"thumbnail":{"type":"string"},"releasedAt":{"type":"string","format":"date-time","nullable":true},"infoUrl":{"type":"string","format":"uri-reference"},"seasonUrl":{"type":"string","format":"uri-reference"},"playable":{"type":"boolean"},"access":{"type":"string","enum":["free","vip"]}}},"PublicSeries":{"type":"object","required":["slug","title","categoryId","status","totalEpisodes","url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"originalTitle":{"type":"string"},"poster":{"type":"string"},"backdrop":{"type":"string"},"description":{"type":"string"},"categoryId":{"type":"integer"},"year":{"type":"string"},"area":{"type":"string"},"status":{"type":"string","enum":["ongoing","completed","paused"]},"expectedEpisodes":{"type":"integer","minimum":0},"totalEpisodes":{"type":"integer","minimum":0},"updatedAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri-reference"}}},"PublicSeriesDetail":{"allOf":[{"$ref":"#/components/schemas/PublicSeries"},{"type":"object","required":["seasons"],"properties":{"seasons":{"type":"array","items":{"$ref":"#/components/schemas/PublicSeriesSeason"}}}}]},"PublicSeriesSeason":{"type":"object","required":["seasonNumber","title","episodeCount","url","episodes"],"properties":{"seasonNumber":{"type":"integer","minimum":1},"title":{"type":"string"},"description":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"episodeCount":{"type":"integer","minimum":0},"url":{"type":"string","format":"uri-reference"},"episodes":{"type":"array","items":{"$ref":"#/components/schemas/SeriesEpisode"}}}},"PublicSeriesSeasonNavigation":{"type":"object","required":["seasonNumber","title","url"],"properties":{"seasonNumber":{"type":"integer","minimum":1},"title":{"type":"string"},"url":{"type":"string","format":"uri-reference"}}},"PublicSeriesSeasonDetail":{"type":"object","required":["series","season","indexable","url"],"properties":{"series":{"$ref":"#/components/schemas/PublicSeries"},"season":{"$ref":"#/components/schemas/PublicSeriesSeason"},"previous":{"$ref":"#/components/schemas/PublicSeriesSeasonNavigation"},"next":{"$ref":"#/components/schemas/PublicSeriesSeasonNavigation"},"indexable":{"type":"boolean"},"url":{"type":"string","format":"uri-reference"}}},"PublicSeriesEpisodeSeason":{"type":"object","required":["seasonNumber","title","episodeCount","url"],"properties":{"seasonNumber":{"type":"integer","minimum":1},"title":{"type":"string"},"description":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"},"episodeCount":{"type":"integer","minimum":0},"url":{"type":"string","format":"uri-reference"}}},"PublicSeriesEpisodeDetail":{"type":"object","required":["series","season","episode","infoUrl","canonicalUrl","url","indexable","summary"],"properties":{"series":{"$ref":"#/components/schemas/PublicSeries"},"season":{"$ref":"#/components/schemas/PublicSeriesEpisodeSeason"},"episode":{"$ref":"#/components/schemas/SeriesEpisode"},"previous":{"$ref":"#/components/schemas/SeriesEpisode","nullable":true},"next":{"$ref":"#/components/schemas/SeriesEpisode","nullable":true},"infoUrl":{"type":"string","format":"uri-reference"},"canonicalUrl":{"type":"string","format":"uri-reference"},"url":{"type":"string","format":"uri-reference"},"indexable":{"type":"boolean"},"summary":{"type":"string"}}},"SeriesPage":{"type":"object","required":["items","status"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicSeries"}},"status":{"type":"string","enum":["all","ongoing","completed","paused"]}}},"PreviewMonth":{"type":"object","required":["month","count"],"properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"count":{"type":"integer","minimum":0},"lastmod":{"type":"string","format":"date-time"}}},"PreviewPage":{"type":"object","required":["month","items","months","total","page","pageCount","pageSize"],"properties":{"month":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicVideo"}},"months":{"type":"array","items":{"$ref":"#/components/schemas/PreviewMonth"}},"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"pageCount":{"type":"integer","minimum":1},"pageSize":{"type":"integer","minimum":1,"maximum":50}}},"TagPage":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicTag"}}}},"PublicTag":{"type":"object","required":["name","canonicalName","slug","count","indexable","url"],"properties":{"name":{"type":"string","description":"Localized display label"},"canonicalName":{"type":"string","description":"Canonical label used by filters and legacy URLs"},"slug":{"type":"string","description":"Editable stable URL slug"},"description":{"type":"string","description":"Optional tag summary"},"count":{"type":"integer","minimum":0},"indexable":{"type":"boolean"},"lastmod":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri-reference"}}},"TagTaxonomyEnvelope":{"type":"object","required":["code","msg","info"],"properties":{"code":{"type":"integer"},"msg":{"type":"string"},"info":{"type":"object","required":["rows"],"properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/TagTaxonomyCategory"}}}}}},"TagTaxonomyCategory":{"type":"object","required":["slug","name","sensitive","collapsedByDefault","supportsUserBlock","groups"],"properties":{"slug":{"type":"string"},"name":{"type":"string","description":"Localized category name"},"sensitive":{"type":"boolean"},"collapsedByDefault":{"type":"boolean"},"supportsUserBlock":{"type":"boolean"},"groups":{"type":"array","items":{"$ref":"#/components/schemas/TagTaxonomyGroup"}}}},"TagTaxonomyGroup":{"type":"object","required":["slug","name","tags"],"properties":{"slug":{"type":"string"},"name":{"type":"string","description":"Localized group name"},"exclusive":{"type":"boolean","description":"Whether the group allows only one selected tag"},"tags":{"type":"array","items":{"$ref":"#/components/schemas/TagTaxonomyTag"}}}},"TagTaxonomyTag":{"type":"object","required":["slug","name","count","bound","dynamic","entityKind","dimension","seed"],"properties":{"slug":{"type":"string","description":"Taxonomy slug used by the tags query parameter"},"name":{"type":"string","description":"Localized tag name"},"count":{"type":"integer","minimum":0,"description":"Works bound to this taxonomy tag in the catalog"},"bound":{"type":"boolean","description":"Whether any catalog tag row is bound to this taxonomy slug"},"dynamic":{"type":"boolean"},"entityKind":{"type":"string","nullable":true},"dimension":{"type":"object","nullable":true,"description":"How this umbrella term lands on the server filter chain: entity (entityType studio|creator, optional relationType) or text (param original). Null means no data support (dimension disabled) or an ordinary dictionary tag.","properties":{"kind":{"type":"string","enum":["entity","text"]},"entityType":{"type":"string","enum":["studio","creator"]},"relationType":{"type":"string","enum":["director","actor","writer","composer","producer"]},"param":{"type":"string","enum":["original"]}}},"seed":{"type":"boolean"}}}}}}