{"openapi":"3.1.0","info":{"title":"ZIP0 Public Media Discovery API","version":"1.1.0","summary":"供智能体和第三方客户端发现 ZIP0 影视、电视与广播资源。","description":"这是无需认证的只读发现 API，可搜索影视内容、电视台、广播电台、正在热播内容和公开收藏夹，并提供可直接访问的 ZIP0 站内 URL。","contact":{"email":"contact@zip0.com"}},"servers":[{"url":"https://zip0.com"}],"tags":[{"name":"videos","description":"电影、电视剧、综艺、动漫和短剧搜索。"},{"name":"tv","description":"电视台发现。"},{"name":"radio","description":"广播电台发现。"},{"name":"broadcasts","description":"当前有用户观看的热门内容。"},{"name":"collections","description":"公开收藏夹发现。"}],"paths":{"/api/videos/search":{"get":{"operationId":"searchVideos","tags":["videos"],"summary":"搜索影视资源","description":"根据片名搜索影视条目。每项提供可直接访问的 ZIP0 观看页面 URL。","parameters":[{"in":"query","name":"query","required":true,"description":"影视名称关键词。","schema":{"type":"string","minLength":1,"maxLength":60},"example":"流浪地球"},{"in":"query","name":"page","description":"页码，从 1 开始。","schema":{"type":"integer","minimum":1,"default":1}},{"in":"query","name":"limit","description":"每页返回数量。","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"分页影视搜索结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSearchResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/tv/channels":{"get":{"operationId":"listTVChannels","tags":["tv"],"summary":"查询电视台","description":"按国家或地区查询电视台，可用 query 过滤名称。每项提供可直接访问的 ZIP0 站内 URL。","parameters":[{"in":"query","name":"country","description":"中文国家或地区名称。","schema":{"type":"string","maxLength":40,"default":"中国"}},{"in":"query","name":"query","description":"可选的电视台名称关键词。","schema":{"type":"string","maxLength":60}},{"in":"query","name":"page","description":"页码，从 1 开始。","schema":{"type":"integer","minimum":1,"default":1}},{"in":"query","name":"limit","description":"每页返回数量。","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"分页电视台结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TVChannelListResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/radio/stations":{"get":{"operationId":"listRadioStations","tags":["radio"],"summary":"查询广播电台","description":"按 ISO 3166-1 alpha-2 国家代码查询广播电台。每项提供可直接访问的 ZIP0 站内 URL。","parameters":[{"in":"query","name":"country","description":"两位大写国家或地区代码。","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","default":"CN"}},{"in":"query","name":"page","description":"页码，从 1 开始。","schema":{"type":"integer","minimum":1,"default":1}},{"in":"query","name":"limit","description":"每页返回数量。","schema":{"type":"integer","minimum":1,"maximum":60,"default":60}}],"responses":{"200":{"description":"分页广播电台结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RadioStationListResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/danmaku-rooms":{"get":{"operationId":"listActiveBroadcasts","tags":["broadcasts"],"summary":"查询正在热播的内容","description":"按当前观看人数降序返回最多 12 个活跃房间，内容可能包括影视、电视直播和广播电台。每项提供可直接访问的 ZIP0 站内相对 URL。","responses":{"200":{"description":"正在热播的内容列表","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveBroadcastListResponse"}}}}}}},"/api/collections":{"get":{"operationId":"listPublicCollections","tags":["collections"],"summary":"列出公开收藏夹","description":"按最近更新时间分页列出公开收藏夹。","parameters":[{"in":"query","name":"page","description":"页码，从 1 开始。","schema":{"type":"integer","minimum":1,"default":1}},{"in":"query","name":"limit","description":"每页返回数量。","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"分页公开收藏夹","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionListResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collections/{collectionId}":{"get":{"operationId":"getPublicCollection","tags":["collections"],"summary":"查看公开收藏夹详情","description":"获取收藏夹信息和一页收藏内容。使用 nextCursor 请求后续内容，每个条目提供可直接访问的 ZIP0 站内 URL。","parameters":[{"in":"path","name":"collectionId","required":true,"description":"收藏夹 ID。","schema":{"type":"string","pattern":"^[a-f0-9]{24}$"}},{"in":"query","name":"cursor","description":"上一页响应中的 nextCursor。","schema":{"type":"string","maxLength":80}}],"responses":{"200":{"description":"公开收藏夹详情","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionDetailResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"收藏夹不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/collections/search":{"get":{"operationId":"searchPublicCollections","tags":["collections"],"summary":"搜索公开收藏夹","description":"按收藏夹名称或描述搜索公开收藏夹。","parameters":[{"in":"query","name":"query","required":true,"description":"收藏夹名称或描述关键词。","schema":{"type":"string","minLength":1,"maxLength":60}},{"in":"query","name":"page","description":"页码，从 1 开始。","schema":{"type":"integer","minimum":1,"default":1}},{"in":"query","name":"limit","description":"每页返回数量。","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"分页公开收藏夹搜索结果","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectionListResponse"}}}},"400":{"description":"请求参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"上游资源服务暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"ErrorResponse":{"type":"object","additionalProperties":false,"required":["success","message"],"properties":{"success":{"type":"boolean","const":false},"message":{"type":"string"}}},"Pagination":{"type":"object","additionalProperties":false,"required":["total","page","limit","pages"],"properties":{"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1},"pages":{"type":"integer","minimum":1}}},"VideoResource":{"type":"object","additionalProperties":false,"required":["kind","title","year","category","area","language","score","remarks","episodeCount","updatedAt","url"],"properties":{"kind":{"type":"string","const":"video"},"title":{"type":"string"},"year":{"type":"string"},"category":{"type":"string"},"area":{"type":"string"},"language":{"type":"string"},"score":{"type":"string"},"remarks":{"type":"string"},"episodeCount":{"type":"integer","minimum":0},"updatedAt":{"type":"string"},"url":{"type":"string","format":"uri"}}},"TVChannel":{"type":"object","additionalProperties":false,"required":["kind","name","country","url"],"properties":{"kind":{"type":"string","const":"tv"},"name":{"type":"string"},"group":{"type":"string"},"country":{"type":"string"},"countryCode":{"type":"string"},"url":{"type":"string","format":"uri"}}},"RadioStation":{"type":"object","additionalProperties":false,"required":["kind","name","tags","country","countryCode","votes","codec","bitrate","url"],"properties":{"kind":{"type":"string","const":"radio"},"name":{"type":"string"},"tags":{"type":"string"},"country":{"type":"string"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"votes":{"type":"integer","minimum":0},"codec":{"type":"string"},"bitrate":{"type":"integer","minimum":0},"url":{"type":"string","format":"uri"}}},"ActiveBroadcast":{"type":"object","additionalProperties":false,"required":["kind","roomId","viewerCount","title","subtitle","image","href"],"properties":{"kind":{"type":"string","enum":["vod","tv","radio"],"description":"内容类型：影视点播、电视直播或广播电台。"},"roomId":{"type":"string","description":"活跃房间标识。"},"viewerCount":{"type":"integer","minimum":1,"description":"当前连接到该房间的观看人数。"},"title":{"type":"string"},"subtitle":{"type":"string"},"image":{"type":"string","description":"内容图片 URL；没有图片时为空字符串。"},"href":{"type":"string","format":"uri-reference","description":"ZIP0 站内观看页的相对 URL。"}}},"PublicCollection":{"type":"object","additionalProperties":false,"required":["kind","id","name","description","viewCount","layoutMode","containsSensitiveContent","itemCount","updatedAt","owner","url"],"properties":{"kind":{"type":"string","const":"collection"},"id":{"type":"string","pattern":"^[a-f0-9]{24}$"},"name":{"type":"string"},"description":{"type":"string"},"viewCount":{"type":"integer","minimum":0},"layoutMode":{"type":"string","enum":["default","topic","playlist"]},"containsSensitiveContent":{"type":"boolean","description":"是否由收藏夹创建者标记为敏感内容。"},"itemCount":{"type":"integer","minimum":0,"description":"收藏夹内全部条目的数量。"},"updatedAt":{"type":"string","format":"date-time"},"owner":{"type":"object","additionalProperties":false,"required":["nickname","avatar"],"properties":{"nickname":{"type":"string"},"avatar":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}}},"url":{"type":"string","format":"uri"}}},"PublicCollectionItem":{"type":"object","additionalProperties":false,"required":["id","type","itemId","title","image","subtitle","year","category","area","language","score","description","director","actors","createdAt","url"],"properties":{"id":{"type":"string","pattern":"^[a-f0-9]{24}$"},"type":{"type":"string","enum":["video","tv","radio","game"]},"itemId":{"type":"string"},"title":{"type":"string"},"image":{"type":"string"},"subtitle":{"type":"string"},"year":{"type":"string"},"category":{"type":"string"},"area":{"type":"string"},"language":{"type":"string"},"score":{"type":"string"},"description":{"type":"string"},"director":{"type":"string"},"actors":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}}},"VideoSearchResponse":{"type":"object","additionalProperties":false,"required":["success","data","pagination","sources"],"properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/VideoResource"}},"pagination":{"$ref":"#/components/schemas/Pagination"},"sources":{"type":"object","additionalProperties":false,"required":["completed","total"],"properties":{"completed":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0}}}}},"TVChannelListResponse":{"type":"object","additionalProperties":false,"required":["success","data","pagination"],"properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/TVChannel"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"RadioStationListResponse":{"type":"object","additionalProperties":false,"required":["success","data","pagination"],"properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/RadioStation"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"ActiveBroadcastListResponse":{"type":"object","additionalProperties":false,"required":["rooms"],"properties":{"rooms":{"type":"array","maxItems":12,"items":{"$ref":"#/components/schemas/ActiveBroadcast"}}}},"CollectionListResponse":{"type":"object","additionalProperties":false,"required":["success","data","pagination"],"properties":{"success":{"type":"boolean","const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicCollection"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"CollectionDetailResponse":{"type":"object","additionalProperties":false,"required":["success","data"],"properties":{"success":{"type":"boolean","const":true},"data":{"type":"object","additionalProperties":false,"required":["collection","items","nextCursor"],"properties":{"collection":{"$ref":"#/components/schemas/PublicCollection"},"items":{"type":"array","items":{"$ref":"#/components/schemas/PublicCollectionItem"}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}}}}}}}}