{ "openapi": "3.0.3", "info": { "title": "FlexTV API", "version": "1.0.0", "description": "FlexTV App + Web API contract documentation." }, "servers": [ { "url": "https://api.flextv.com", "description": "Production" }, { "url": "https://api-t.flextv.cc", "description": "Testing" } ], "tags": [ { "name": "InitBiz" }, { "name": "Push" }, { "name": "Auth" }, { "name": "User" }, { "name": "CollectAndHistory" }, { "name": "UserV2" }, { "name": "SubscribeVip" }, { "name": "Index" }, { "name": "Video" }, { "name": "Series" }, { "name": "AliHls" }, { "name": "QiNiu" }, { "name": "Tencent" }, { "name": "H5" }, { "name": "Feedback" }, { "name": "Pay" }, { "name": "Popularise" }, { "name": "AppLog" }, { "name": "Recommend" }, { "name": "task" }, { "name": "taskV2" }, { "name": "Debug" }, { "name": "Email" }, { "name": "Share" }, { "name": "Active" }, { "name": "Advertising" }, { "name": "Invite" }, { "name": "AppSearch" }, { "name": "ShortLink" }, { "name": "Comment" }, { "name": "PrizeWheels" }, { "name": "DirectToCustomer" }, { "name": "SiteMessage" }, { "name": "noticeSwitch" }, { "name": "UsersBonus" }, { "name": "SeriesClassify" }, { "name": "Redirect" }, { "name": "Story" }, { "name": "H5Novel" }, { "name": "Health" }, { "name": "Game" }, { "name": "Social" }, { "name": "Turbolink" }, { "name": "WebCommon" }, { "name": "WebIndex" }, { "name": "WebTag" }, { "name": "WebSeries" }, { "name": "WebSearch" }, { "name": "WebUgcWork" }, { "name": "WebRecommend" }, { "name": "Web Recommend" }, { "name": "Web Comment" }, { "name": "Web Resource" }, { "name": "WebLog" }, { "name": "Web TurboLink" }, { "name": "Docs" } ], "paths": { "/SaleSmartly/Notify": { "post": { "tags": [ "DirectToCustomer" ], "summary": "Sale Smartly Notify", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_DirectToCustomer_SaleSmartlyNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/active/getActiveInfo": { "get": { "tags": [ "Active" ], "summary": "获取活动信息", "description": "响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Active_getActiveInfo", "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "uid", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "recharge_sub_originate", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "link_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/active/getActiveTime": { "get": { "tags": [ "Active" ], "summary": "获取活动时间", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Active_getActiveTime", "parameters": [ { "name": "recharge_sub_originate", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/active/getSeriesList": { "get": { "tags": [ "Active" ], "summary": "获取剧集信息", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Active_getSeriesList", "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "uid", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "recharge_sub_originate", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/active/testServer": { "get": { "tags": [ "Active" ], "summary": "Test Server", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Active_testServer", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/ad/adCallback": { "post": { "tags": [ "Advertising" ], "summary": "Ad Callback", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Advertising_adCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "ad_unit_id": { "type": "string" }, "ad_unit_name": { "type": "string" }, "country_code": { "type": "string" }, "custom_data": { "type": "string" }, "event_id": { "type": "string" }, "idfa": { "type": "string" }, "idfv": { "type": "string" }, "ip": { "type": "string" }, "network_name": { "type": "string" }, "package_name": { "type": "string" }, "placement": { "type": "string" }, "platform": { "type": "string" }, "ts": { "type": "integer" }, "user_id": { "type": "integer" }, "ext": { "type": "string" }, "event_token_all": { "type": "string" } } } } } } } }, "/ad/advertisingList": { "get": { "tags": [ "Advertising" ], "summary": "Advertising List", "description": "响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Advertising_advertisingList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/ad/appsflyer": { "post": { "tags": [ "Advertising" ], "summary": "Appsflyer", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Advertising_appsflyer", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/ad/dataCensus": { "post": { "tags": [ "Advertising" ], "summary": "Data Census", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Advertising_dataCensus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/ad/h5advertisingList": { "get": { "tags": [ "Advertising" ], "summary": "H5advertising List", "description": "响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Advertising_h5advertisingList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/ad/userCanAdUnlock": { "get": { "tags": [ "Advertising" ], "summary": "User Can Ad Unlock", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Advertising_userCanAdUnlock", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "section_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/airwallex/callback": { "post": { "tags": [ "Pay" ], "summary": "Airwallex Callback", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_airwallexCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string" }, "order_id": { "type": "string" }, "checkout_id": { "type": "string" }, "intent_id": { "type": "string" }, "id": { "type": "string" }, "type": { "type": "string" } } } } } } } }, "/airwallex/notify": { "post": { "tags": [ "Pay" ], "summary": "Airwallex Notify", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_airwallexNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/appConfig": { "get": { "tags": [ "InitBiz" ], "summary": "下发官网地址", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_InitBiz_appConfig", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/appSearch/hotSeries": { "get": { "tags": [ "AppSearch" ], "summary": "Hot Series", "description": "响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_AppSearch_hotSeries", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/appSearch/hotWords": { "get": { "tags": [ "AppSearch" ], "summary": "Hot Words", "description": "响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_AppSearch_hotWords", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/appSearch/search": { "get": { "tags": [ "AppSearch" ], "summary": "Search", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_AppSearch_search", "parameters": [ { "name": "keyword", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/applePay": { "post": { "tags": [ "Pay" ], "summary": "apple 支付验证", "description": "响应契约：OrderResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_applePay", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/applePayNotify": { "post": { "tags": [ "Pay" ], "summary": "apple支付通知", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Pay_applePayNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/appleSignature": { "post": { "tags": [ "Pay" ], "summary": "Apple Signature", "description": "响应契约：SignatureResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_appleSignature", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignatureResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "signature": "signature_demo", "nonce": "nonce_demo", "timestamp": 1710000000, "keyIdentifier": "key-demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignatureResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "appBundleID": { "type": "string" }, "productIdentifier": { "type": "string" }, "offerIdentifier": { "type": "string" }, "applicationUsername": { "type": "string" }, "appAccountToken": { "type": "string" } } } } } } } }, "/auth/testToken": { "get": { "tags": [ "Auth" ], "summary": "注销账号", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Auth_testToken", "parameters": [ { "name": "uid", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "app", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/authRegister": { "post": { "tags": [ "Auth" ], "summary": "授权注册（登录）", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_authRegister", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/bonus/notify": { "post": { "tags": [ "UsersBonus" ], "summary": "Notify", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_UsersBonus_notify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/bonus/notify2": { "post": { "tags": [ "UsersBonus" ], "summary": "Notify2", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_UsersBonus_notify2", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/closeAccount": { "post": { "tags": [ "Auth" ], "summary": "注销账号", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_closeAccount", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/collect": { "post": { "tags": [ "CollectAndHistory" ], "summary": "追剧接口", "description": "新增或取消剧集收藏，并返回最新收藏数展示值。\n\n响应契约：CollectResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_CollectAndHistory_collect", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "series_id": 1001, "collect_num_str": "88" } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "剧集 ID，可为单个或批量标识。" }, "is_delete": { "type": "integer", "description": "1 表示取消收藏，0 表示收藏。" }, "video_type": { "type": "integer" } }, "required": [ "series_id" ] } } } } } }, "/commentGuide": { "get": { "tags": [ "Comment" ], "summary": "评论展示场景。", "description": "APP 端所有页面固定为�\n�开浏览区（public），即评论区显示开�\n��\n�闭的评论一律屏蔽。\nWeb 端在子类中重写，可按页面传�\n� seo 场景。\nprotected function getDisplayScene(): string\n{\nreturn CommentLogic::DISPLAY_SCENE_PUBLIC;\n}\n是否弹出正常评论引导\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Comment_commentGuide", "parameters": [ { "name": "scene", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/completeTask": { "post": { "tags": [ "task" ], "summary": "完成任务", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_task_completeTask", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "activity_type": { "type": "string" }, "task_id": { "type": "string" }, "series_id": { "type": "string" }, "series_no": { "type": "string" } } } } } } } }, "/confirmCommentGuide": { "get": { "tags": [ "Comment" ], "summary": "提交去评论", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Comment_confirmCommentGuide", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/consumeTradeNotice": { "post": { "tags": [ "Pay" ], "summary": "核销交易通知", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_consumeTradeNotice", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/cosOssSyncCallback": { "post": { "tags": [ "Tencent" ], "summary": "Cos Oss Sync Callback", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Tencent_cosOssSyncCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/createOrder": { "post": { "tags": [ "Pay" ], "summary": "创建订单", "description": "响应契约：OrderResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_createOrder", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/createOrderH5": { "post": { "tags": [ "Pay" ], "summary": "创建订单(针对h5活动页)", "description": "响应契约：OrderResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_createOrderH5", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "payment": { "type": "string" }, "is_subscription": { "type": "string" }, "recharge_originate": { "type": "string" }, "recharge_sub_originate": { "type": "string" }, "recharge_source": { "type": "string" } } } } } } } }, "/createOrderH5V2": { "post": { "tags": [ "Pay" ], "summary": "创建订单(针对h5活动页,非加密版本)", "description": "响应契约：OrderResult。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Pay_createOrderH5V2", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/createOrderWeb": { "post": { "tags": [ "Pay" ], "summary": "Web 创建订单", "description": "创建 Web 官网订单，支付方式和可用商品会受当前用户上下文与支付配置影响。\n\n响应契约：OrderResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_createOrderWeb", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "recharge_product_id": { "type": "integer", "description": "充值商品 ID。" }, "payment": { "type": "string", "description": "支付方式标识。" }, "country_code": { "type": "string", "description": "国家码。" } } } } } } } }, "/decrypt": { "post": { "tags": [ "AliHls" ], "summary": "Decrypt", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_AliHls_decrypt", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "MtsHlsUriToken": { "type": "string" }, "Ciphertext": { "type": "string" } } } } } } } }, "/docs/openapi.json": { "get": { "tags": [ "Docs" ], "summary": "获取 OpenAPI JSON", "description": "返回项目当前生成的 OpenAPI JSON 文档。认证要求：无需登录。", "operationId": "docsOpenapiJson", "responses": { "200": { "description": "OpenAPI JSON", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/email/pushStatistics": { "post": { "tags": [ "Email" ], "summary": "Push Statistics", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Email_pushStatistics", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/email/unsubscribe": { "post": { "tags": [ "Email" ], "summary": "Unsubscribe", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Email_unsubscribe", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/emailLogin": { "post": { "tags": [ "Auth" ], "summary": "邮箱密码登录", "description": "使用邮箱和密码登录账号。\n\n响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_emailLogin", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" }, "password": { "type": "string", "description": "登录密码。" } }, "required": [ "email", "password" ] } } } } } }, "/emailRegister": { "post": { "tags": [ "Auth" ], "summary": "邮箱密码注册", "description": "使用邮箱、密码和验证码完成账号注册。\n\n响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_emailRegister", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" }, "password": { "type": "string", "description": "登录密码。" }, "code": { "type": "string", "description": "邮箱验证码。" } }, "required": [ "email", "password", "code" ] } } } } } }, "/eventTrack": { "post": { "tags": [ "AppLog" ], "summary": "事件追踪埋点", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_AppLog_eventTrack", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "event_id": { "type": "string" }, "event_key": { "type": "string" }, "timestamp": { "type": "string" }, "item_id": { "type": "string" }, "event_source": { "type": "string" }, "order_id": { "type": "string" }, "section_id": { "type": "string" }, "is_initiative": { "type": "string" }, "amount": { "type": "string" }, "floor_id": { "type": "string" }, "floor_inner_id": { "type": "string" } } } } } } } }, "/floorData": { "get": { "tags": [ "WebIndex" ], "summary": "获取首页楼层数据列表", "description": "返回指定 Web 首页楼层的内容列表，list 项包含展示态收藏数 collect_num 与格式化字段 collect_num_str。\n\n响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_getIndexFloorDataList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 18。", "schema": { "type": "integer", "description": "每页条数，默认 18。" } }, { "name": "floor_id", "in": "query", "required": true, "description": "楼层 ID。", "schema": { "type": "integer", "description": "楼层 ID。" } }, { "name": "title", "in": "query", "required": false, "description": "展示标题。", "schema": { "type": "string", "description": "展示标题。" } }, { "name": "url_title", "in": "query", "required": false, "description": "URL 标题。", "schema": { "type": "string", "description": "URL 标题。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/game/adPermission": { "get": { "tags": [ "Game" ], "summary": "看广告权限", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Game_adPermission", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/game/adReward": { "post": { "tags": [ "Game" ], "summary": "看广告奖励", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Game_adReward", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "game_params": { "type": "string" } } } } } } } }, "/game/getMyList": { "get": { "tags": [ "Game" ], "summary": "Get My List", "description": "Return the current user's game My List, including recently played and you may like sections.\n\n响应契约：GameMyList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Game_getMyList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "Page number.", "schema": { "type": "integer", "description": "Page number." } }, { "name": "page_size", "in": "query", "required": false, "description": "Page size.", "schema": { "type": "integer", "description": "Page size." } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/GameMyList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "recently_play": [ { "game_id": 1001, "frontend_name": "Hero Story", "intro": "Fast-paced adventure game.", "icon_url": "https://cdn.flextv.com/game/hero-story.png", "game_url": "https://play.flextv.com/hero-story", "score": 4.8, "last_play_at": 1710000000, "play_count": 3 } ], "you_may_like": [ { "game_id": 1002, "frontend_name": "Pixel Warrior", "intro": "Arcade action challenge.", "icon_url": "https://cdn.flextv.com/game/pixel-warrior.png", "game_url": "https://play.flextv.com/pixel-warrior", "score": 4.6, "sort": 90 } ], "paging": { "page_no": 1, "page_size": 1000, "total": 0 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/GameMyList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/game/recordRecentPlay": { "post": { "tags": [ "Game" ], "summary": "Record Recent Play", "description": "Record the current user's recent game play by game_id.\n\n响应契约：GameRecentPlayResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Game_recordRecentPlay", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/GameRecentPlayResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "matched": 1, "game": { "game_id": 1001, "frontend_name": "Hero Story", "intro": "Fast-paced adventure game.", "icon_url": "https://cdn.flextv.com/game/hero-story.png", "game_url": "https://play.flextv.com/hero-story", "score": 4.8 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/GameRecentPlayResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "game_id": { "type": "integer", "description": "Game ID." } }, "required": [ "game_id" ] } } } } } }, "/getAppMyList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "Get App My List", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_getAppMyList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getAppRankingList": { "get": { "tags": [ "Index" ], "summary": "获取App榜单列表", "description": "返回 App 榜单页列表数据。\n\n响应契约：RankingList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getAppRankingList", "parameters": [ { "name": "rank_tab_id", "in": "query", "required": false, "description": "榜单 Tab ID。", "schema": { "type": "integer", "description": "榜单 Tab ID。" } }, { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 20。", "schema": { "type": "integer", "description": "每页条数，默认 20。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/RankingList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "ranking_tab": [ { "rank_tab_id": 1, "rank_tab_name": "Top", "lang": "en" } ], "ranking_list": [ { "rank_tab_id": 1, "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "series_topic": "", "show_video_type": 0, "icon_type": 0, "icon_text": "", "icon_color": "", "icon": "", "tag_list": [ "Romance" ], "tag": "Romance" } ], "paging": { "page_no": 1, "page_size": 20, "total": 1 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/RankingList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getBannerList": { "get": { "tags": [ "Index" ], "summary": "首页轮播图列表", "description": "返回 App 首页轮播图数据。\n\n响应契约：BannerList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getBannerList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/BannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001, "description": "Drama description", "tags": [ { "tag_id": 81, "tag_name": "Future", "url_title": "Future", "web_tag_id": "wym0wzej9" } ] } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/BannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getCarouselRecommend": { "get": { "tags": [ "Recommend" ], "summary": "轮播推荐", "description": "返回播放器轮播推荐内容。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getCarouselRecommend", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "alert_type", "in": "query", "required": false, "description": "弹窗类型，默认 2。", "schema": { "type": "integer", "description": "弹窗类型，默认 2。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getCoinFlow": { "get": { "tags": [ "User" ], "summary": "获取金币流水", "description": "返回当前用户的 coin 流水记录，按分页读取。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getCoinFlow", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getCollectList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "收藏历史", "description": "返回 App 端收藏列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_getCollectList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getExtBonus": { "get": { "tags": [ "PrizeWheels" ], "summary": "获取额外奖励", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_PrizeWheels_getExtBonus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getFeedbackList": { "get": { "tags": [ "Feedback" ], "summary": "Get Feedback List", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Feedback_getFeedbackList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getFeedbackTypeList": { "get": { "tags": [ "Feedback" ], "summary": "Get Feedback Type List", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Feedback_getFeedbackTypeList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/getHistoryList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "观看历史", "description": "返回 App 端观看历史列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_getHistoryList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getHoveringRecommend": { "get": { "tags": [ "Recommend" ], "summary": "悬浮推荐", "description": "返回播放器悬浮推荐配置。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getHoveringRecommend", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "alert_type", "in": "query", "required": false, "description": "弹窗类型。", "schema": { "type": "integer", "description": "弹窗类型。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorDataList": { "get": { "tags": [ "Index" ], "summary": "获取首页楼层数据列表", "description": "返回指定首页楼层下的内容列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorDataList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "floor_id", "in": "query", "required": true, "description": "楼层 ID。", "schema": { "type": "integer", "description": "楼层 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorDataListV3": { "get": { "tags": [ "Index" ], "summary": "获取首页楼层数据列表V3", "description": "返回指定首页楼层下的内容列表，支持按内容类型切换。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorDataListV3", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "floor_id", "in": "query", "required": true, "description": "楼层 ID。", "schema": { "type": "integer", "description": "楼层 ID。" } }, { "name": "content_type", "in": "query", "required": false, "description": "内容类型，1 表示短故事。", "schema": { "type": "integer", "description": "内容类型，1 表示短故事。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorDataListV4": { "get": { "tags": [ "Index" ], "summary": "获取首页楼层数据列表V4", "description": "返回指定首页楼层下的内容列表，支持按内容类型切换。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorDataListV4", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "floor_id", "in": "query", "required": true, "description": "楼层 ID。", "schema": { "type": "integer", "description": "楼层 ID。" } }, { "name": "content_type", "in": "query", "required": false, "description": "内容类型，1 表示短故事。", "schema": { "type": "integer", "description": "内容类型，1 表示短故事。" } }, { "name": "classify_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorList": { "get": { "tags": [ "Index" ], "summary": "首页楼层列表 (App版本号 <= 1.5.0)", "description": "响应契约：IndexFloorList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorList", "parameters": [ { "name": "refresh_history", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "nav": [ { "nav_id": 1, "nav_name": "Home" } ], "banner": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001 } ], "floor": [ { "title": "Popular", "url_title": "popular", "template_type": 1, "list": [] } ], "paging": { "page_no": 1, "page_size": 20, "total": 0 }, "list": [] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorListV2": { "get": { "tags": [ "Index" ], "summary": "首页楼层列表 (App版本号 > 2.0.0)", "description": "返回新版 App 首页楼层列表。\n\n响应契约：IndexFloorList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorListV2", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "nav_id", "in": "query", "required": false, "description": "导航 ID。", "schema": { "type": "integer", "description": "导航 ID。" } }, { "name": "refresh_history", "in": "query", "required": false, "description": "是否刷新历史标记。", "schema": { "type": "integer", "description": "是否刷新历史标记。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "nav": [ { "nav_id": 1, "nav_name": "Home" } ], "banner": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001 } ], "floor": [ { "title": "Popular", "url_title": "popular", "template_type": 1, "list": [] } ], "paging": { "page_no": 1, "page_size": 20, "total": 0 }, "list": [] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorListV3": { "get": { "tags": [ "Index" ], "summary": "首页楼层列表 (App版本号 >= 3.9.4)", "description": "返回新版 App 首页楼层列表，支持分类维度过滤。\n\n响应契约：IndexFloorList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorListV3", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "classify_id", "in": "query", "required": false, "description": "分类 ID。", "schema": { "type": "integer", "description": "分类 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "nav": [ { "nav_id": 1, "nav_name": "Home" } ], "banner": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001 } ], "floor": [ { "title": "Popular", "url_title": "popular", "template_type": 1, "list": [] } ], "paging": { "page_no": 1, "page_size": 20, "total": 0 }, "list": [] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexFloorListV4": { "get": { "tags": [ "Index" ], "summary": "首页楼层列表 (App版本号 >= 4.6.8)", "description": "返回新版 App 首页楼层列表，支持分类维度过滤。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexFloorListV4", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "classify_id", "in": "query", "required": false, "description": "分类 ID。", "schema": { "type": "integer", "description": "分类 ID。" } }, { "name": "tag_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getIndexNavList": { "get": { "tags": [ "Index" ], "summary": "首页剧集推荐导航列表", "description": "返回首页推荐导航配置。\n\n响应契约：TagList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getIndexNavList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "tag_id": 1, "tag_name": "Romance", "url_title": "romance", "web_tag_id": "m8k2p4z6" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getLikeList": { "get": { "tags": [ "User" ], "summary": "点赞（最爱）列表", "description": "返回当前用户的点赞内容列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getLikeList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getPlayInfo": { "get": { "tags": [ "Video" ], "summary": "获取授权播放链接", "description": "返回 App 端授权播放链接。\n\n响应契约：SeriesInfo。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Video_getPlayInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "section_id", "in": "query", "required": true, "description": "分集 ID。", "schema": { "type": "integer", "description": "分集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getPrizeWheelsAward": { "get": { "tags": [ "PrizeWheels" ], "summary": "转盘奖品", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_PrizeWheels_getPrizeWheelsAward", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getPrizeWheelsResult": { "get": { "tags": [ "PrizeWheels" ], "summary": "转动转盘", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_PrizeWheels_getPrizeWheelsResult", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getPromotionProducts": { "get": { "tags": [ "Pay" ], "summary": "获取促销产品", "description": "响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getPromotionProducts", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRechargeList": { "get": { "tags": [ "Pay" ], "summary": "获取�", "description": "值档位列表\n\n响应契约：PaymentPanelV4。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRechargeList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "top_list": [], "list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "popup_info": [], "count_down": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRechargeListV3": { "get": { "tags": [ "Pay" ], "summary": "获取�", "description": "值档位列表(V3版本)(APP>=2.9)\n\n响应契约：PaymentPanelV4。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRechargeListV3", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "top_list": [], "list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "popup_info": [], "count_down": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRechargeListV4": { "get": { "tags": [ "Pay" ], "summary": "获取�", "description": "值档位列表(V4版本)(APP>=3.0.0)\n\n响应契约：PaymentPanelV4。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRechargeListV4", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "top_list": [], "list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "popup_info": [], "count_down": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRechargeListV5": { "get": { "tags": [ "Pay" ], "summary": "获取�", "description": "值档位列表(V5版本)(APP>=3.8.0)\n\n响应契约：PaymentPanelV5。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRechargeListV5", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV5" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "retain_way": 0, "bannerLevelList": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "normalLevelList": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vipList": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV5" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRechargeListV6": { "get": { "tags": [ "Pay" ], "summary": "Get Recharge List V6", "description": "响应契约：PaymentPanelV5。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRechargeListV6", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV5" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "retain_way": 0, "bannerLevelList": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "normalLevelList": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vipList": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV5" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRecommendPageList": { "get": { "tags": [ "Recommend" ], "summary": "推荐页列表", "description": "返回推荐页列表数据。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getRecommendPageList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 30。", "schema": { "type": "integer", "description": "每页条数，默认 30。" } }, { "name": "is_first", "in": "query", "required": false, "description": "是否首次加载。", "schema": { "type": "integer", "description": "是否首次加载。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRecommendPageListV2": { "get": { "tags": [ "Recommend" ], "summary": "推荐页列表 V3.9.5", "description": "返回新版推荐页列表数据。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getRecommendPageListV2", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 40。", "schema": { "type": "integer", "description": "每页条数，默认 40。" } }, { "name": "is_default", "in": "query", "required": false, "description": "是否回退默认配置。", "schema": { "type": "integer", "description": "是否回退默认配置。" } }, { "name": "is_first", "in": "query", "required": false, "description": "是否首次加载。", "schema": { "type": "integer", "description": "是否首次加载。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRestoreRechargeListAnd": { "get": { "tags": [ "Pay" ], "summary": "安卓获取�", "description": "�档位商品\n\n响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRestoreRechargeListAnd", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRestoreRechargeListH5": { "get": { "tags": [ "Pay" ], "summary": "补单档位列表（H5页面）", "description": "响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRestoreRechargeListH5", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRestoreRechargeListV3": { "get": { "tags": [ "Pay" ], "summary": "补单档位列表（V3版本）(APP>=2.9)", "description": "响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRestoreRechargeListV3", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getRestoreRechargeListV5": { "get": { "tags": [ "Pay" ], "summary": "补单档位列表（V5版本）(APP>=3.8.0)", "description": "响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getRestoreRechargeListV5", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getSeriesRecommendList": { "get": { "tags": [ "Recommend" ], "summary": "剧集推荐", "description": "根据推荐位返回对应的推荐剧集列表。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getSeriesRecommendList", "parameters": [ { "name": "position", "in": "query", "required": true, "description": "推荐位标识。", "schema": { "type": "integer", "description": "推荐位标识。" } }, { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "page_no", "in": "query", "required": false, "description": "页码。", "schema": { "type": "integer", "description": "页码。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数。", "schema": { "type": "integer", "description": "每页条数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getSeriesShareInfo": { "get": { "tags": [ "Share" ], "summary": "App播放页 - 获取剧集分享信息", "description": "返回 App 端剧集、UGC 作品或合集的分享信息。\n\n响应契约：ShareInfo。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Share_getSeriesShareInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "内容 ID。", "schema": { "type": "integer", "description": "内容 ID。" } }, { "name": "obj_type", "in": "query", "required": false, "description": "内容类型，5 表示 UGC 视频。", "schema": { "type": "integer", "description": "内容类型，5 表示 UGC 视频。" } }, { "name": "sub_type", "in": "query", "required": false, "description": "UGC 子类型，1 作品，2 合集。", "schema": { "type": "integer", "description": "UGC 子类型，1 作品，2 合集。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ShareInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "share_url": "https://www.flextv.cc/s0/demo", "share_content": [ "Watch this series", "Join now" ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ShareInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getSpecialBanner": { "get": { "tags": [ "Index" ], "summary": "获取追剧页/任务频道banner", "description": "返回不同场景下的专题 banner。\n\n响应契约：BannerList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Index_getSpecialBanner", "parameters": [ { "name": "scene", "in": "query", "required": false, "description": "1 追剧页，2 任务频道页，3 评论页。", "schema": { "type": "integer", "description": "1 追剧页，2 任务频道页，3 评论页。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/BannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001, "description": "Drama description", "tags": [ { "tag_id": 81, "tag_name": "Future", "url_title": "Future", "web_tag_id": "wym0wzej9" } ] } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/BannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getTaskList": { "get": { "tags": [ "task" ], "summary": "获取任务列表", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_task_getTaskList", "parameters": [ { "name": "watch_num", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getTrailerRecommend": { "get": { "tags": [ "Recommend" ], "summary": "预告片推荐", "description": "返回剧集相关预告片推荐列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getTrailerRecommend", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getTransactionStatus": { "get": { "tags": [ "Pay" ], "summary": "获取交易状态", "description": "响应契约：TransactionStatus。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getTransactionStatus", "parameters": [ { "name": "trade_no", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TransactionStatus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "status": 1, "order_id": "900000000000000001", "trade_id": "trade_demo_001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TransactionStatus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getUgcRechargeList": { "get": { "tags": [ "Pay" ], "summary": "Get Ugc Recharge List", "description": "响应契约：PaymentPanelV4。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getUgcRechargeList", "parameters": [ { "name": "collection_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "top_list": [], "list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "popup_info": [], "count_down": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getUnconsumedTradeList": { "get": { "tags": [ "Pay" ], "summary": "获取未核销的交易列表", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getUnconsumedTradeList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getUserInfo": { "get": { "tags": [ "User" ], "summary": "用户信息", "description": "返回 App 端当前登录用户的基础资料、签到奖励和评论开关等聚合信息。\n\n响应契约：UserProfile。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getUserInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "uid": 10001, "user_name": "10001", "avatar": "https://cdn.flextv.com/avatar.png", "nick": "10001", "coin": 1200, "bonus": 300, "has_pay": 1, "user_group": 1, "user_group_extended": 0, "country_code": "US", "vip_type": 0, "vip_expire_at": "", "open_comment": 1, "sign_prize": 20 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getVideoPlayAuth": { "get": { "tags": [ "Video" ], "summary": "获取授权凭证", "description": "返回视频播放授权凭证。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Video_getVideoPlayAuth", "parameters": [ { "name": "video_id", "in": "query", "required": false, "description": "视频资源 ID。", "schema": { "type": "string", "description": "视频资源 ID。" } }, { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "section_id", "in": "query", "required": true, "description": "分集 ID。", "schema": { "type": "integer", "description": "分集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getWebRechargeList": { "get": { "tags": [ "Pay" ], "summary": "Web 获取充值档位列表", "description": "返回 Web 充值面板数据，包含支付方式、内购档位与订阅档位。命中充值弹窗 AB 实验且不是已有 VIP 的用户，充值页和充值弹窗均返回后台按权重降序配置的前 3 个订阅档位，并忽略状态及页面展示开关；已有 VIP 仍不返回订阅档位。订阅档位包含定价相关字段：is_discount、pricing_type_text、discount_price、product_price、offer_id。\n\n响应契约：PaymentPanelWeb。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getWebRechargeList", "parameters": [ { "name": "recharge_scene", "in": "query", "required": false, "description": "充值场景：1=充值页，2=充值弹窗。", "schema": { "type": "integer", "description": "充值场景：1=充值页，2=充值弹窗。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "payment_list": [ { "payment": 4, "payment_name": "paypal", "platform": 2, "payment_icon": "https://file-cdn.flextv.cc/image/82/f3d094824d36568b8fee5b0c462189.png" } ], "recharge_list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "vip_list": [ { "recharge_id": "1001", "store_product_id": "prod_vip_1001", "base_plan_id": "base_vip_1001", "product_type": 2, "package_type": 1, "is_discount": 1, "pricing_type_text": "tiered", "discount_price": "9.99", "product_price": "19.99", "coin": 0, "free_coin": 0, "recharge_originate": 5, "third_party": [], "corner_mark_text": "VIP", "page_corner_mark_text": "VIP", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 0, "subtitle": "VIP", "offer_id": "coupon_intro_50off" } ], "default_payment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelWeb" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getWhatsappLink": { "get": { "tags": [ "DirectToCustomer" ], "summary": "获取私域链接", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_DirectToCustomer_getWhatsappLink", "parameters": [ { "name": "scene", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/getWorkLikeList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "点赞列表", "description": "响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_getLikeList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/googlePay": { "post": { "tags": [ "Pay" ], "summary": "google 支付验证", "description": "响应契约：OrderResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_googlePay", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/googlePayNotify": { "post": { "tags": [ "Pay" ], "summary": "Google Pay支付通知", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Pay_googlePayNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5/closeAccount": { "get": { "tags": [ "H5" ], "summary": "注销账号", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5_closeAccount", "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5/helpCenter": { "get": { "tags": [ "H5" ], "summary": "帮助中心", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5_helpCenter", "parameters": [ { "name": "lang", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5/privacyPolicy": { "get": { "tags": [ "H5" ], "summary": "隐私协议", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5_privacyPolicy", "parameters": [ { "name": "theme", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5/support": { "get": { "tags": [ "H5" ], "summary": "Support", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5_support", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5/userAgreement": { "get": { "tags": [ "H5" ], "summary": "用户协议", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5_userAgreement", "parameters": [ { "name": "theme", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5Novel/checkActivityDisplay": { "get": { "tags": [ "H5Novel" ], "summary": "检查活动是否展示", "description": "响应契约：SeriesCardList。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_checkActivityDisplay", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5Novel/completeReadingTask": { "post": { "tags": [ "H5Novel" ], "summary": "完成�", "description": "读任务\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_H5Novel_completeReadingTask", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "novel_id": { "type": "string" }, "chapter_number": { "type": "string" }, "is_ad": { "type": "string" } } } } } } } }, "/h5Novel/getBannerEntry": { "get": { "tags": [ "H5Novel" ], "summary": "Banner�", "description": "�口接口\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getBannerEntry", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/h5Novel/getChapterContent": { "get": { "tags": [ "H5Novel" ], "summary": "获取章节�", "description": "容\n\n响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getChapterContent", "parameters": [ { "name": "novel_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "chapter_number", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5Novel/getChapterList": { "get": { "tags": [ "H5Novel" ], "summary": "获取章节列表", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getChapterList", "parameters": [ { "name": "novel_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5Novel/getDailyBonusList": { "get": { "tags": [ "H5Novel" ], "summary": "获取每日福利列表", "description": "响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getDailyBonusList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/h5Novel/getNovelList": { "get": { "tags": [ "H5Novel" ], "summary": "H5小说控制器", "description": "Class H5Novel\nclass H5Novel extends ApiController\n{\n不需要登录的接口\nprotected $noLoginNode = [\n'H5Novel/getNovelList',\n'H5Novel/getChapterContent',\n'H5Novel/getChapterList',\n'H5Novel/checkActivityDisplay'\n];\nprotected $noLimitRiskUserNode = [\n'H5Novel/getNovelList',\n'H5Novel/getChapterContent',\n'H5Novel/getChapterList',\n'H5Novel/checkActivityDisplay'\n];\nprotected $noLimitTestEnvAccessNode = [\n'H5Novel/getNovelList',\n'H5Novel/getChapterContent',\n'H5Novel/getChapterList',\n'H5Novel/checkActivityDisplay',\n'H5Novel/getBannerEntry',\n'H5Novel/getDailyBonusList',\n'H5Novel/getUserReadingHistory',\n'H5Novel/updateReadingProgress',\n'H5Novel/completeReadingTask',\n'H5Novel/getTaskProgress',\n];\nprotected $noSignatureNode = [\n'H5Novel/getNovelList',\n'H5Novel/getChapterContent',\n'H5Novel/getChapterList',\n'H5Novel/checkActivityDisplay',\n'H5Novel/getBannerEntry',\n'H5Novel/getDailyBonusList',\n'H5Novel/getUserReadingHistory',\n'H5Novel/updateReadingProgress',\n'H5Novel/completeReadingTask',\n'H5Novel/getTaskProgress',\n];\nprotected $noEncryptNode = [\n'H5Novel/getNovelList',\n'H5Novel/getChapterContent',\n'H5Novel/getChapterList',\n'H5Novel/checkActivityDisplay',\n'H5Novel/getBannerEntry',\n'H5Novel/getDailyBonusList',\n'H5Novel/getUserReadingHistory',\n'H5Novel/updateReadingProgress',\n'H5Novel/completeReadingTask',\n'H5Novel/getTaskProgress',\n];\n获取小说列表\n\n响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getNovelList", "parameters": [ { "name": "language", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/h5Novel/getTaskProgress": { "get": { "tags": [ "H5Novel" ], "summary": "获取本地化错误信息", "description": "private function getLocalizedErrorMessage(\\Exception $e): string\n{\n$code = $e->getCode();\nswitch ($code) {\ncase 30020: // h5NovelActivityDisabledErr\nreturn lang('30020');\ncase 30021: // h5NovelNotFoundErr\nreturn lang('30021');\ncase 30022: // h5NovelChapterNotFoundErr\nreturn lang('30022');\ncase 30023: // h5NovelChapterAlreadyClaimedErr\nreturn lang('30023');\ncase 30024: // h5NovelDailyLimitReachedErr\nreturn lang('30024');\ncase 30025: // h5NovelReadingProgressInsufficientErr\nreturn lang('30025');\ncase 30026: // h5NovelTaskRecordCreateFailErr\nreturn lang('30026');\ncase 30027: // h5NovelInsufficientCoinsErr\nreturn lang('30027');\ncase 30028: // h5NovelSystemErr\nreturn lang('30028');\ncase 30029: // h5NovelParamErr\nreturn lang('30029');\ncase 10004: // OperateFrequentlyErr\nreturn lang('10004');\ndefault:\nreturn lang('30028'); // 默认使用H5小说系统错误\n}\n}\n获取任务进度\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getTaskProgress", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/h5Novel/getUserReadingHistory": { "get": { "tags": [ "H5Novel" ], "summary": "获取用户�", "description": "读历史\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_H5Novel_getUserReadingHistory", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/h5Novel/updateReadingProgress": { "post": { "tags": [ "H5Novel" ], "summary": "更新�", "description": "读进度\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_H5Novel_updateReadingProgress", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "novel_id": { "type": "string" }, "chapter_number": { "type": "string" }, "progress_percentage": { "type": "string" }, "scroll_position": { "type": "string" }, "reading_position": { "type": "string" } } } } } } } }, "/health": { "post": { "tags": [ "Health" ], "summary": "健康", "description": "class Health extends ApiController\n{\nprotected $noSignatureNode = ['health/check', 'health/test'];\nprotected $noLimitChinaIPNode = ['health/check', 'health/test'];\nprotected $noLoginNode = ['health/check', 'health/test'];\nprotected $noLimitRiskUserNode = ['health/check', 'health/test'];\nprotected $noLimitTestEnvAccessNode = ['health/check', 'health/test'];\n给运维监控php-fpm\n\n响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 响应会经过加密中间件。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "any_Health_check", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/history/delHistory": { "post": { "tags": [ "CollectAndHistory" ], "summary": "删除观看历史", "description": "删除指定剧集的观看历史。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_CollectAndHistory_delHistory", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "剧集 ID。" } }, "required": [ "series_id" ] } } } } } }, "/hlsEvent": { "post": { "tags": [ "AliHls" ], "summary": "Hls Event", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_AliHls_hlsEvent", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "EventType": { "type": "string" }, "VideoId": { "type": "string" }, "Status": { "type": "string" }, "StreamInfos": { "type": "array", "items": { "type": "string" } }, "FileUrl": { "type": "string" }, "CoverUrl": { "type": "string" }, "SnapshotInfos": { "type": "array", "items": { "type": "string" } }, "Extend": { "type": "string" } } } } } } } }, "/hlsEventTmp": { "post": { "tags": [ "AliHls" ], "summary": "Hls Event Tmp", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_AliHls_hlsEventTmp", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "EventType": { "type": "string" }, "VideoId": { "type": "string" }, "Status": { "type": "string" }, "StreamInfos": { "type": "array", "items": { "type": "string" } }, "FileUrl": { "type": "string" }, "CoverUrl": { "type": "string" }, "SnapshotInfos": { "type": "array", "items": { "type": "string" } }, "Extend": { "type": "string" } } } } } } } }, "/initConfig": { "get": { "tags": [ "InitBiz" ], "summary": "初始化APP需要的�", "description": "�置\n\n响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_InitBiz_initConfig", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/invite/fullInInviteCode": { "post": { "tags": [ "Invite" ], "summary": "填邀请码", "description": "响应契约：EmptyObject。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Invite_fullInInviteCode", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/invite/invitePageInfo": { "get": { "tags": [ "Invite" ], "summary": "邀请页信息", "description": "响应契约：SeriesInfo。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Invite_invitePageInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/invite/inviteRecordList": { "get": { "tags": [ "Invite" ], "summary": "邀请明细列表", "description": "响应契约：ListPage。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Invite_inviteRecordList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/invite/inviteSeries": { "get": { "tags": [ "Invite" ], "summary": "邀请的短剧列表", "description": "响应契约：SeriesCardList。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Invite_inviteSeries", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/isGoogleAccessible": { "post": { "tags": [ "InitBiz" ], "summary": "Is Google Accessible", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_InitBiz_isGoogleAccessible", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "if_used": { "type": "string" }, "price_info": { "type": "string" } } } } } } } }, "/lastHistory": { "get": { "tags": [ "CollectAndHistory" ], "summary": "上次观看的视频", "description": "返回当前用户最近一次观看记录。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_lastHistory", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/logout": { "post": { "tags": [ "Auth" ], "summary": "账号退出登录", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_logout", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/getClassificationList": { "get": { "tags": [ "SiteMessage" ], "summary": "获取站�", "description": "信分类列表\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SiteMessage_getClassificationList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "classification", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/getList": { "get": { "tags": [ "SiteMessage" ], "summary": "获取站�", "description": "信列表\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SiteMessage_getList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/getListV2": { "get": { "tags": [ "SiteMessage" ], "summary": "获取站�", "description": "信列表\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SiteMessage_getListV2", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/getSiteMsgNotReadNums": { "get": { "tags": [ "SiteMessage" ], "summary": "获取未读的消息数量", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SiteMessage_getSiteMsgNotReadNums", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/getStatus": { "get": { "tags": [ "SiteMessage" ], "summary": "获取站�", "description": "信�\n�口状态（是否显示红点）\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SiteMessage_getStatus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/readMessage": { "post": { "tags": [ "SiteMessage" ], "summary": "读站�", "description": "信接口\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_SiteMessage_readMessage", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/message/readMessageV2": { "post": { "tags": [ "SiteMessage" ], "summary": "读站�", "description": "信接口\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_SiteMessage_readMessageV2", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/notice/getStatus": { "get": { "tags": [ "noticeSwitch" ], "summary": "通知开�", "description": "�\nClass NoticeSwitch\nclass NoticeSwitch extends ApiController\n{\n获取通知�\n�置\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_noticeSwitch_getStatus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/notice/setStatus": { "post": { "tags": [ "noticeSwitch" ], "summary": "设置通知�", "description": "�置\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_noticeSwitch_setStatus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "all_notice_status": { "type": "integer" }, "sign_notice_status": { "type": "integer" }, "recommend_notice_status": { "type": "integer" }, "activity_notice_status": { "type": "integer" }, "like_notice_status": { "type": "integer" }, "comment_notice_status": { "type": "integer" }, "publish_work_notice_status": { "type": "integer" } } } } } } } }, "/orderFail": { "post": { "tags": [ "Pay" ], "summary": "取消订单或通知失败订单", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_orderFail", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/p/{code}": { "get": { "tags": [ "Popularise" ], "summary": "获取推广链接信息（落地页） - 有推广链接", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Popularise_populariseLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "group_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "creative_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "campaign_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "adset_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "ad_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "uuid", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/pay/airwallexHpp": { "get": { "tags": [ "Pay" ], "summary": "Airwallex HPP 桥接页：加载 Airwallex.js 并跳转托管收银台", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Pay_airwallexHpp", "parameters": [ { "name": "order_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/pay/getPaymentResult": { "get": { "tags": [ "Pay" ], "summary": "获取付款结果", "description": "响应契约：TransactionStatus。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getPaymentResult", "parameters": [ { "name": "order_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TransactionStatus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "status": 1, "order_id": "900000000000000001", "trade_id": "trade_demo_001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TransactionStatus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/pay/getThirdPartyPayment": { "get": { "tags": [ "Pay" ], "summary": "获取可用第三方支付方式", "description": "响应契约：SimpleMap。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getThirdPartyPayment", "parameters": [ { "name": "watch_num", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "pay_source", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "data": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/pay/getThirdPartyPaymentV2": { "get": { "tags": [ "Pay" ], "summary": "Get Third Party Payment V2", "description": "响应契约：SimpleMap。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_getThirdPartyPaymentV2", "parameters": [ { "name": "watch_num", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "pay_source", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "data": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/pay/thirdPartyFail": { "post": { "tags": [ "Pay" ], "summary": "三方支付失败/取消", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_thirdPartyFail", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string" } } } } } } } }, "/pay/thirdPartyRedirect": { "get": { "tags": [ "Pay" ], "summary": "三方支付跳转", "description": "响应契约：SimpleMap。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Pay_thirdPartyRedirect", "parameters": [ { "name": "order_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "data": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/pay/thirdPartySuccess/{paymentName}": { "post": { "tags": [ "Pay" ], "summary": "三方支付成功", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_thirdPartySuccess", "parameters": [ { "name": "paymentName", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string" } } } } } } } }, "/payerMax/callback": { "post": { "tags": [ "Pay" ], "summary": "Payer Max Callback", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_payerMaxCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "outTradeNo": { "type": "string" }, "tradeToken": { "type": "string" }, "status": { "type": "string" }, "lang": { "type": "string" } } } } } } } }, "/payerMax/notify": { "post": { "tags": [ "Pay" ], "summary": "PayerMax 回调通知", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_payerMaxNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/paymentRecord": { "post": { "tags": [ "Pay" ], "summary": "记录付款记录（只是记录，不做有效验证）", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Pay_paymentRecord", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/paypal/capture": { "post": { "tags": [ "Pay" ], "summary": "PayPal扣款", "description": "用户支付完成后，调用此接口请求PayPal进行扣款\n\n响应契约：OrderResult。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Pay_payPalCapture", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "order_id": "900000000000000001", "payment_url": "https://api.flextv.cc/pay/thirdPartyRedirect?order_id=900000000000000001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/OrderResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/paypal/notify": { "post": { "tags": [ "Pay" ], "summary": "Paypal 回调通知", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_payPalNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/popularise/campaign": { "get": { "tags": [ "Popularise" ], "summary": "获取推广链接信息（落地页） - 无推广链接，通过CampaignId匹�", "description": "�链接，匹�\n�不到则生成新推广链接\n\n响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Popularise_populariseCampaign", "parameters": [ { "name": "campaign_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "pixel_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_type", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "campaign_name", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/popularise/doServerMatching": { "post": { "tags": [ "Popularise" ], "summary": "系统模糊匹�", "description": "�\n\n响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_doServerMatching", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "matching_id": { "type": "string" } } } } } } } }, "/popularise/matchLinkInfo": { "post": { "tags": [ "Popularise" ], "summary": "匹�", "description": "�推广链接\n\n响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_matchLinkInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/popularise/purchaseConversion": { "get": { "tags": [ "Popularise" ], "summary": "购买转换开�", "description": "�\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Popularise_purchaseConversion", "parameters": [ { "name": "order_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/popularise/report": { "post": { "tags": [ "Popularise" ], "summary": "app 上报推广链接ID", "description": "响应契约：EmptyObject。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_report", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/popularise/reportUserClick": { "post": { "tags": [ "Popularise" ], "summary": "上报用户点击按钮事件（落地页）", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_reportUserClick", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "link_id": { "type": "string" }, "visit_id": { "type": "string" }, "uuid": { "type": "string" }, "type": { "type": "string" }, "style_type": { "type": "string" } } } } } } } }, "/popularise/reportUserInfo": { "post": { "tags": [ "Popularise" ], "summary": "上报用户信息（落地页）", "description": "响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_reportUserInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "link_id": { "type": "string" }, "url": { "type": "string" }, "fbp": { "type": "string" }, "fbc": { "type": "string" }, "fb_external_id": { "type": "string" }, "ttp": { "type": "string" }, "uuid": { "type": "string" }, "sc_id": { "type": "string" }, "sc_id_r": { "type": "string" }, "style_type": { "type": "string" } } } } } } } }, "/popularise/reportUserInfoGeneral": { "post": { "tags": [ "Popularise" ], "summary": "上报用户信息（通用和自动跳转落地页）", "description": "响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_reportUserInfoGeneral", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" }, "fbp": { "type": "string" }, "fbc": { "type": "string" }, "fb_external_id": { "type": "string" }, "ttp": { "type": "string" }, "uuid": { "type": "string" }, "sc_id": { "type": "string" }, "sc_id_r": { "type": "string" }, "style_type": { "type": "string" }, "code": { "type": "string" }, "group_id": { "type": "string" }, "creative_id": { "type": "string" } } } } } } } }, "/popularise/reportUserInfoH5": { "post": { "tags": [ "Popularise" ], "summary": "上报用户信息（H5直投落地页）", "description": "响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Popularise_reportUserInfoH5", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "link_id": { "type": "string" }, "group_id": { "type": "string" }, "creative_id": { "type": "string" }, "url": { "type": "string" }, "fbp": { "type": "string" }, "fbc": { "type": "string" }, "fb_external_id": { "type": "string" }, "ttp": { "type": "string" }, "uuid": { "type": "string" }, "sc_id": { "type": "string" }, "sc_id_r": { "type": "string" }, "style_type": { "type": "string" } } } } } } } }, "/preview/{code}": { "get": { "tags": [ "Popularise" ], "summary": "预览落地页信息", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Popularise_previewTemplate", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/push/pushStatistics": { "post": { "tags": [ "Push" ], "summary": "Push Statistics", "description": "响应契约：EmptyObject。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Push_pushStatistics", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "statistics_id": { "type": "integer" }, "start_type": { "type": "integer" } } } } } } } }, "/push/reportDeviceToken": { "post": { "tags": [ "Push" ], "summary": "Report Device Token", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Push_reportDeviceToken", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "device_token": { "type": "string" } } } } } } } }, "/push/reportStart": { "post": { "tags": [ "Push" ], "summary": "Report Start", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Push_reportStart", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/qiNiu/mp4Trans": { "post": { "tags": [ "QiNiu" ], "summary": "Mp4Trans", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_QiNiu_mp4Trans", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/qiNiu/persistentNotify": { "post": { "tags": [ "QiNiu" ], "summary": "Persistent Notify", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_QiNiu_persistentNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/qiNiu/uploadCallback": { "post": { "tags": [ "QiNiu" ], "summary": "Upload Callback", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_QiNiu_uploadCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/qiNiu/videoCropNotify": { "post": { "tags": [ "QiNiu" ], "summary": "视频截取通知-", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_QiNiu_videoCropNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "scene": { "type": "string" } } } } } } } }, "/qiNiu/videoProgressiveNotify": { "post": { "tags": [ "QiNiu" ], "summary": "Video Progressive Notify", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_QiNiu_videoProgressiveNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/quitRecommendList": { "get": { "tags": [ "Recommend" ], "summary": "退出播放器推荐", "description": "返回退出播放器时展示的推荐列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_quitRecommendList", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/receiveTaskReward": { "post": { "tags": [ "task" ], "summary": "领取奖励", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_task_receiveTaskReward", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "activity_type": { "type": "string" }, "task_id": { "type": "string" } } } } } } } }, "/rechargeList": { "get": { "tags": [ "Pay" ], "summary": "web端获取�", "description": "值档位列表(V4版本)\n\n响应契约：PaymentPanelV4。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Pay_webGetRechargeListV4", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "top_list": [], "list": [ { "recharge_id": "R-1001", "store_product_id": "prod_1001", "base_plan_id": "base_1001", "product_type": 1, "package_type": 1, "product_price": "9.99", "coin": 100, "free_coin": 20, "free_ratio": "20%", "corner_mark_text": "Popular", "corner_mark_type": 1, "page_corner_mark_text": "Popular", "page_corner_mark_type": 1, "original_price_coefficient": "1", "is_selected": 1, "subtitle": "Best value", "third_party": [], "card_style": 0 } ], "popup_info": [], "count_down": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/PaymentPanelV4" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getFistPagePop": { "get": { "tags": [ "Recommend" ], "summary": "首页弹窗", "description": "返回首页弹窗推荐列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getFistPagePop", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getFistPagePopV2": { "get": { "tags": [ "Recommend" ], "summary": "首页弹窗", "description": "返回首页弹窗推荐列表。响应 data 直接为数组。pop_up_style 枚举：0=通用、1=爱情、2=古装、3=萌宝、4=逆袭、5=整图（整图样式下前端直接展示 image 字段的图片，不再叠加样式模板）。\n\n响应契约：FirstPagePopupList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getFistPagePopV2", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID，用于过滤自身。", "schema": { "type": "integer", "description": "当前剧集 ID，用于过滤自身。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/FirstPagePopupList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "id": 2001, "recommend_name": "Hot Drama Popup", "image": "https://cdn.flextv.com/popup/full-image.jpg", "jump_type": "play", "jump_value": "1001", "pop_up_style": 5, "url": "", "series_id": 1001, "is_collect": 0, "tags": [], "end_time": 1710000000000, "every_hour": 24, "pop_time": 1, "home_status": 1, "foryou_status": 0, "play_status": 0 } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/FirstPagePopupList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getFistPagePopV3": { "get": { "tags": [ "Recommend" ], "summary": "Get one first page popup V3.", "description": "Return one popup. Old first-page popup list is rotated on server side; if old popup is empty, fallback to drama popup V2.\n\n响应契约：HomePopupItem。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getFistPagePopV3", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "Current series id, used to filter self.", "schema": { "type": "integer", "description": "Current series id, used to filter self." } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomePopupItem" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "id": 2001, "config_id": 2001, "source_config_id": 492, "popup_source": 1, "recommend_name": "Hot Drama Popup", "image": "https://cdn.flextv.com/popup/full-image.jpg", "cover": "https://cdn.flextv.com/cover/1001.jpg", "jump_type": "play", "jump_value": "1001", "pop_up_style": 5, "url": "", "series_id": 1001, "series_name": "Hot Drama", "trace_id": "fpv3_2001_550e8400-e29b-41d4-a716-446655440000", "request_id": "fpv3_2001_550e8400-e29b-41d4-a716-446655440000", "every_hour": 24, "pop_time": 1, "daily_limit": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomePopupItem" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getHomeSuspend": { "get": { "tags": [ "Recommend" ], "summary": "使用�", "description": "返回首页悬浮推荐内容。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getHomeSuspend", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getPlayListRecommend": { "get": { "tags": [ "Recommend" ], "summary": "播放记录页推荐页列表", "description": "返回播放记录页推荐内容。该接口无需登录。\n\n响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getPlayListRecommend", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/recommend/getPromotionRecommend": { "get": { "tags": [ "Recommend" ], "summary": "促销弹窗推荐列表", "description": "返回促销弹窗推荐内容。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getPromotionRecommend", "parameters": [ { "name": "filter_ids", "in": "query", "required": false, "description": "需要排除的内容 ID 集合。", "schema": { "type": "string", "description": "需要排除的内容 ID 集合。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/getSceneSuspend": { "get": { "tags": [ "Recommend" ], "summary": "多场景悬浮弹窗", "description": "一次性返回 home、foryou、play 三个场景的悬浮弹窗配置。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_getSceneSuspend", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommend/reportHomePopupEvent": { "post": { "tags": [ "Recommend" ], "summary": "从 startIndex 起环形查找第一条仍满足服务端滑动窗口频控的老弹窗。", "description": "Report exposure/click/close event for first page popup. Exposure event returns preloaded next popup in data.next_popup.\n\n响应契约：HomePopupEventReportResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Recommend_reportHomePopupEvent", "parameters": [ { "name": "trace_id", "in": "query", "required": false, "description": "Popup trace id returned by getFistPagePopV3.", "schema": { "type": "string", "description": "Popup trace id returned by getFistPagePopV3." } }, { "name": "request_id", "in": "query", "required": false, "description": "Popup request id returned by getFistPagePopV3. Used when trace_id is empty.", "schema": { "type": "string", "description": "Popup request id returned by getFistPagePopV3. Used when trace_id is empty." } }, { "name": "config_id", "in": "query", "required": true, "description": "Popup config id.", "schema": { "type": "integer", "description": "Popup config id." } }, { "name": "series_id", "in": "query", "required": true, "description": "Popup series id.", "schema": { "type": "integer", "description": "Popup series id." } }, { "name": "popup_source", "in": "query", "required": true, "description": "Popup source from getFistPagePopV3/report response: 1=legacy(old first-page popup), 2=drama(fallback popup).", "schema": { "type": "integer", "description": "Popup source from getFistPagePopV3/report response: 1=legacy(old first-page popup), 2=drama(fallback popup)." } }, { "name": "event_type", "in": "query", "required": true, "description": "Event type: 1=exposure, 2=click, 3=close.", "schema": { "type": "integer", "description": "Event type: 1=exposure, 2=click, 3=close." } }, { "name": "current_series_id", "in": "query", "required": false, "description": "Current playing series id, used to filter self when preloading next popup.", "schema": { "type": "integer", "description": "Current playing series id, used to filter self when preloading next popup." } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomePopupEventReportResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "next_popup": { "id": 2002, "config_id": 2002, "popup_source": 1, "recommend_name": "Next Popup", "image": "https://cdn.flextv.com/popup/next.jpg", "jump_type": "play", "jump_value": "1002", "series_id": 1002, "series_name": "Next Drama", "trace_id": "fpv3_2002_550e8400-e29b-41d4-a716-446655440001", "request_id": "fpv3_2002_550e8400-e29b-41d4-a716-446655440001", "every_hour": 24, "pop_time": 1, "daily_limit": 1 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomePopupEventReportResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recommendNextSeriesInfo": { "get": { "tags": [ "Recommend" ], "summary": "推荐下一部剧集信息", "description": "返回当前剧集播放结束后的下一部推荐信息。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_recommendNextSeriesInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "当前剧集 ID。", "schema": { "type": "integer", "description": "当前剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recordHistory": { "get": { "tags": [ "CollectAndHistory" ], "summary": "记录看过的视频", "description": "记录 App 端用户观看进度。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_recordHistory", "parameters": [ { "name": "section_id", "in": "query", "required": true, "description": "分集 ID。", "schema": { "type": "integer", "description": "分集 ID。" } }, { "name": "duration", "in": "query", "required": false, "description": "当前播放时长，单位秒。", "schema": { "type": "integer", "description": "当前播放时长，单位秒。" } }, { "name": "resolution", "in": "query", "required": false, "description": "清晰度标识。", "schema": { "type": "string", "description": "清晰度标识。" } }, { "name": "is_end", "in": "query", "required": false, "description": "当前分集是否播放完成。", "schema": { "type": "integer", "description": "当前分集是否播放完成。" } }, { "name": "series_is_end", "in": "query", "required": false, "description": "当前剧集是否已播放至结尾。", "schema": { "type": "integer", "description": "当前剧集是否已播放至结尾。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recsearch/feed/item": { "get": { "tags": [ "Recommend" ], "summary": "RecSearch 推荐 Feed 单项", "description": "根据短剧和集数返回兼容 `/recsearch/feed/recommend` 的单个 item 结构。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_recsearchFeedItem", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "续播剧 ID。", "schema": { "type": "integer", "description": "续播剧 ID。" } }, { "name": "series_no", "in": "query", "required": false, "description": "续播集序号；不传时按历史播放集，否则第 1 集。", "schema": { "type": "integer", "description": "续播集序号；不传时按历史播放集，否则第 1 集。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/recsearch/feed/recommend": { "get": { "tags": [ "Recommend" ], "summary": "RecSearch 推荐 Feed", "description": "返回兼容 ugc-api-go `/recsearch/feed/recommend` 的短剧推荐流。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Recommend_recsearchFeedRecommend", "parameters": [ { "name": "cursor", "in": "query", "required": false, "description": "分页游标。", "schema": { "type": "string", "description": "分页游标。" } }, { "name": "tag_ids", "in": "query", "required": false, "description": "标签 ID，逗号分隔。", "schema": { "type": "string", "description": "标签 ID，逗号分隔。" } }, { "name": "is_first", "in": "query", "required": false, "description": "是否首次启动。", "schema": { "type": "integer", "description": "是否首次启动。" } }, { "name": "series_id", "in": "query", "required": false, "description": "续播剧 ID，新推荐模式下生效。", "schema": { "type": "integer", "description": "续播剧 ID，新推荐模式下生效。" } }, { "name": "series_no", "in": "query", "required": false, "description": "续播集序号，新推荐模式下生效。", "schema": { "type": "integer", "description": "续播集序号，新推荐模式下生效。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/redirect": { "get": { "tags": [ "Redirect" ], "summary": "Index", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Redirect_index", "parameters": [ { "name": "url", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/refreshToken": { "post": { "tags": [ "Auth" ], "summary": "刷新token接口", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_refreshToken", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "account_type": { "type": "string" } } } } } } } }, "/refreshUrl": { "get": { "tags": [ "Video" ], "summary": "刷新cdn鉴权过期url", "description": "刷新已过期或即将过期的 CDN 鉴权地址。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Video_refreshUrl", "parameters": [ { "name": "url", "in": "query", "required": true, "description": "原始播放地址。", "schema": { "type": "string", "description": "原始播放地址。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/repairIosMatchLink": { "post": { "tags": [ "Debug" ], "summary": "Repair Ios Match Link", "description": "响应契约：EmptyObject。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Debug_repairIosMatchLink", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/replyStatus": { "get": { "tags": [ "Feedback" ], "summary": "Reply Status", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Feedback_replyStatus", "parameters": [ { "name": "is_read", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/reportAppLog": { "post": { "tags": [ "AppLog" ], "summary": "信息收集", "description": "class AppLog extends ApiController\n{\n收集app日志\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_AppLog_reportAppLog", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "event_code": { "type": "string" }, "event_reason": { "type": "string" }, "event_detail": { "type": "string" } } } } } } } }, "/reportAppStart": { "post": { "tags": [ "InitBiz" ], "summary": "初始业务", "description": "Return the app initialization config, including the dynamic show_game_list_tab flag.\n\n响应契约：AppConfig。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_InitBiz_reportAppStart", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AppConfig" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "positive_vote_star": 4, "min_play_time": 30, "invite_tab_url": "https://m.flextv.com/invite", "extend_check_time": 1, "show_game_list_tab": 1, "lang": [ { "lang_code": "en", "lang": "English" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AppConfig" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "start_type": { "type": "string" }, "idfa": { "type": "string" }, "idfv": { "type": "string" }, "gaid": { "type": "string" }, "check_emulator": { "type": "string" }, "is_first": { "type": "string" }, "last_app_source": { "type": "string" }, "notification_permissions": { "type": "string" }, "pip_permissions": { "type": "string" } } } } } } } }, "/reportAppsFlyer": { "post": { "tags": [ "InitBiz" ], "summary": "上报AppsFlyer信息", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_InitBiz_reportAppsFlyer", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "appsflyer_id": { "type": "string" } } } } } } } }, "/reportDataV3": { "post": { "tags": [ "AppLog" ], "summary": "Report Data V3", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_AppLog_reportDataV3", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "report_data": { "type": "string" } } } } } } } }, "/reportPlayDuration": { "post": { "tags": [ "AppLog" ], "summary": "上报播放时长", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_AppLog_reportPlayDuration", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string" }, "section_id": { "type": "string" }, "duration": { "type": "string" }, "video_type": { "type": "string" }, "scene": { "type": "string" } } } } } } } }, "/resetPassword": { "post": { "tags": [ "Auth" ], "summary": "重置密码", "description": "使用验证码完成密码重置。\n\n响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_resetPassword", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" }, "code": { "type": "string", "description": "邮箱验证码。" }, "password": { "type": "string", "description": "新密码。" } }, "required": [ "email", "code", "password" ] } } } } } }, "/s0/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "shareShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_shareShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s10/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s11/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s29/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s30/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s31/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s32/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s33/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s34/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s35/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s36/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s37/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s38/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s39/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s4/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s40/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s7/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "populariseShortLink", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_populariseShortLink", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s8/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "ugcCampaign", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_ugcCampaign", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/s9/{code}": { "get": { "tags": [ "ShortLink" ], "summary": "ugcRanking", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_ShortLink_ugcRanking", "parameters": [ { "name": "code", "in": "path", "required": true, "description": "路由路径参数。", "schema": { "type": "string", "description": "路由路径参数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/saleSmartly/message": { "post": { "tags": [ "DirectToCustomer" ], "summary": "SaleSmartlyMessage", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_DirectToCustomer_SaleSmartlyMessage", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/sendEmailCode": { "post": { "tags": [ "Auth" ], "summary": "发送邮箱验证码", "description": "用于邮箱注册流程，向目标邮箱发送 6 位验证码。\n\n响应契约：SimpleFlag。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_sendEmailCode", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleFlag" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "sent": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleFlag" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" } }, "required": [ "email" ] } } } } } }, "/sendResetPasswordCode": { "post": { "tags": [ "Auth" ], "summary": "发送找回密码验证码", "description": "向已注册邮箱发送找回密码验证码。\n\n响应契约：SimpleFlag。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_sendResetPasswordCode", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleFlag" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "sent": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleFlag" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" } }, "required": [ "email" ] } } } } } }, "/series/adUnlockIsSuccess": { "get": { "tags": [ "Series" ], "summary": "用于判断广告解锁是否成功", "description": "校验广告解锁结果，成功后会补充收藏与回传逻辑。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_series_adUnlockIsSuccess", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "section_id", "in": "query", "required": true, "description": "分集 ID。", "schema": { "type": "integer", "description": "分集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getAdRewardTaskList": { "get": { "tags": [ "Series" ], "summary": "获取广告激励任务列表", "description": "返回当前用户可领取的广告激励任务列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Series_getAdRewardTaskList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getSeriesInfo": { "get": { "tags": [ "Series" ], "summary": "获取剧集信息", "description": "返回剧集详情页所需的聚合信息。\n\n响应契约：SeriesInfo。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_series_getSeriesInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getSeriesPreviewInfo": { "get": { "tags": [ "Series" ], "summary": "获取新片预告详�", "description": "返回预告片详情。\n\n响应契约：TrailerDetail。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_series_getSeriesPreviewInfo", "parameters": [ { "name": "preview_id", "in": "query", "required": true, "description": "预告片 ID。", "schema": { "type": "integer", "description": "预告片 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TrailerDetail" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "preview_id": 1, "series_id": 1001, "title": "Trailer Demo", "cover": "https://cdn.flextv.com/trailer.jpg" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TrailerDetail" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getSeriesSectionFullList": { "get": { "tags": [ "Series" ], "summary": "视频选集接口（不分页）", "description": "响应契约：SeriesSectionBundle。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Series_getSeriesSectionFullList", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_id_origin": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "series_status": 1, "description": "Demo description", "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "like_num_str": "12", "last_series_no": 24, "current_series_no": 1, "current_range_id": 1, "recently_series_no": 1, "video_duration": "01:30", "tag_ids": "1,2", "series_level": 1, "trial_time": 300, "release_protection": 0, "lang": "en", "director": "Director", "writer": "Writer", "starring": "Actor A, Actor B", "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "unit_price": 10, "progress": "UPDATE_TO_EPISODE_24" }, "tag": [ { "tag_id": 1, "tag_name": "Romance", "web_tag_id": "web_tag_1" } ], "range_size": 20, "range_list": [ { "range_id": 1, "start_series_no": 1, "end_series_no": 20 } ], "list": [ { "id": 1, "series_id": 1001, "series_no": 1, "video_id": 2001, "is_charge": 0, "unit_price": 0, "like_num": 12, "like_num_str": "12", "watch_num": "1.2K", "has_pay": 1, "is_like": 1, "cover": "https://cdn.flextv.com/series.jpg", "summary": "Episode 1 summary", "video_duration": 120, "publish_time": 1710000000, "lang": "en" } ], "play_info": { "video_url": "https://cdn.flextv.com/video.m3u8", "progressive": [], "subtitle": [], "is_trial": 0, "duration": 120, "upload_date": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getSeriesSectionFullListV2": { "get": { "tags": [ "Series" ], "summary": "视频选集接口（不分页） (App版本号 >= 2.0.0)", "description": "返回剧集全集列表，适合选集面板直接展示。\n\n响应契约：SeriesSectionBundle。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Series_getSeriesSectionFullListV2", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "series_no", "in": "query", "required": false, "description": "当前集数。", "schema": { "type": "integer", "description": "当前集数。" } }, { "name": "source", "in": "query", "required": false, "description": "来源标识。", "schema": { "type": "integer", "description": "来源标识。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_id_origin": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "series_status": 1, "description": "Demo description", "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "like_num_str": "12", "last_series_no": 24, "current_series_no": 1, "current_range_id": 1, "recently_series_no": 1, "video_duration": "01:30", "tag_ids": "1,2", "series_level": 1, "trial_time": 300, "release_protection": 0, "lang": "en", "director": "Director", "writer": "Writer", "starring": "Actor A, Actor B", "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "unit_price": 10, "progress": "UPDATE_TO_EPISODE_24" }, "tag": [ { "tag_id": 1, "tag_name": "Romance", "web_tag_id": "web_tag_1" } ], "range_size": 20, "range_list": [ { "range_id": 1, "start_series_no": 1, "end_series_no": 20 } ], "list": [ { "id": 1, "series_id": 1001, "series_no": 1, "video_id": 2001, "is_charge": 0, "unit_price": 0, "like_num": 12, "like_num_str": "12", "watch_num": "1.2K", "has_pay": 1, "is_like": 1, "cover": "https://cdn.flextv.com/series.jpg", "summary": "Episode 1 summary", "video_duration": 120, "publish_time": 1710000000, "lang": "en" } ], "play_info": { "video_url": "https://cdn.flextv.com/video.m3u8", "progressive": [], "subtitle": [], "is_trial": 0, "duration": 120, "upload_date": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getSeriesSectionList": { "get": { "tags": [ "Series" ], "summary": "视频选集接口（分页）", "description": "返回剧集分页选集列表。\n\n响应契约：SeriesSectionBundle。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Series_getSeriesSectionList", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "page_no", "in": "query", "required": false, "description": "页码。", "schema": { "type": "integer", "description": "页码。" } }, { "name": "series_no", "in": "query", "required": false, "description": "当前集数。", "schema": { "type": "integer", "description": "当前集数。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_id_origin": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "series_status": 1, "description": "Demo description", "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "like_num_str": "12", "last_series_no": 24, "current_series_no": 1, "current_range_id": 1, "recently_series_no": 1, "video_duration": "01:30", "tag_ids": "1,2", "series_level": 1, "trial_time": 300, "release_protection": 0, "lang": "en", "director": "Director", "writer": "Writer", "starring": "Actor A, Actor B", "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "unit_price": 10, "progress": "UPDATE_TO_EPISODE_24" }, "tag": [ { "tag_id": 1, "tag_name": "Romance", "web_tag_id": "web_tag_1" } ], "range_size": 20, "range_list": [ { "range_id": 1, "start_series_no": 1, "end_series_no": 20 } ], "list": [ { "id": 1, "series_id": 1001, "series_no": 1, "video_id": 2001, "is_charge": 0, "unit_price": 0, "like_num": 12, "like_num_str": "12", "watch_num": "1.2K", "has_pay": 1, "is_like": 1, "cover": "https://cdn.flextv.com/series.jpg", "summary": "Episode 1 summary", "video_duration": 120, "publish_time": 1710000000, "lang": "en" } ], "play_info": { "video_url": "https://cdn.flextv.com/video.m3u8", "progressive": [], "subtitle": [], "is_trial": 0, "duration": 120, "upload_date": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionBundle" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/getTrailerList": { "get": { "tags": [ "Series" ], "summary": "获取预告片列表", "description": "返回预告片列表。\n\n响应契约：TrailerList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_series_getTrailerList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TrailerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "preview_id": 1, "series_id": 1001, "title": "Trailer Demo", "cover": "https://cdn.flextv.com/trailer.jpg", "page_no": 1 } ], "paging": { "page_no": 1, "page_size": 20, "total": 1 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TrailerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/series/unlockVideo": { "post": { "tags": [ "Series" ], "summary": "解锁分集", "description": "使用用户资产解锁指定分集。\n\n响应契约：UnlockResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Series_unlockVideo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UnlockResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "coin": 12, "bonus": 3 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UnlockResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "section_id": { "type": "integer", "description": "分集 ID。" } }, "required": [ "section_id" ] } } } } } }, "/seriesAppoint": { "post": { "tags": [ "User" ], "summary": "预约预告片", "description": "预约待上线剧集的预告内容。\n\n响应契约：ActionResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_seriesAppoint", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ActionResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "result": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ActionResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "preview_id": { "type": "integer", "description": "预告片 ID。" } }, "required": [ "preview_id" ] } } } } } }, "/seriesClassify/getClassify": { "get": { "tags": [ "SeriesClassify" ], "summary": "Get Classify", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SeriesClassify_getClassify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/seriesClassify/getClassifyBanner": { "get": { "tags": [ "SeriesClassify" ], "summary": "根据当前语言获取短剧分类,banner图", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SeriesClassify_getClassifyBanner", "parameters": [ { "name": "classify_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/seriesComment/deleteComment": { "post": { "tags": [ "Comment" ], "summary": "删除一条评论", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Comment_deleteSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string" }, "video_type": { "type": "integer" }, "comment_id": { "type": "string" } } } } } } } }, "/seriesComment/likeComment": { "post": { "tags": [ "Comment" ], "summary": "点赞/取消点赞", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Comment_likeSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string" }, "video_type": { "type": "integer" }, "comment_id": { "type": "string" }, "is_like": { "type": "string" } } } } } } } }, "/seriesComment/parentCommentList": { "get": { "tags": [ "Comment" ], "summary": "剧集父评论列表", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Comment_seriesParentCommentList", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "series_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "video_type", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "top_comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "cut_time", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "exclude_comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/seriesComment/subCommentList": { "get": { "tags": [ "Comment" ], "summary": "剧集子评论列表", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Comment_seriesSubCommentList", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "series_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "video_type", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "parent_comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "last_comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "exclude_comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/seriesComment/writeComment": { "post": { "tags": [ "Comment" ], "summary": "Write a series comment.", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Comment_writeSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string" }, "video_type": { "type": "integer" }, "series_no": { "type": "string" }, "parent_comment_id": { "type": "string" }, "sub_comment_id": { "type": "string" }, "comment_content": { "type": "string" } } } } } } } }, "/seriesLike": { "post": { "tags": [ "User" ], "summary": "剧集点赞/取消", "description": "对剧集或剧集分集执行点赞、取消点赞，并返回最新点赞数展示值。\n\n响应契约：LikeResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_seriesLike", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/LikeResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "like_num_str": "12" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/LikeResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "integer", "description": "剧集 ID。" }, "section_id": { "type": "integer", "description": "分集 ID，点赞分集时需要。" }, "is_delete": { "type": "integer", "description": "1 表示取消点赞，0 表示点赞。" }, "like_source": { "type": "integer", "description": "点赞来源，2 表示剧集维度，其余为分集维度。" } }, "required": [ "series_id" ] } } } } } }, "/share/getCampFollowInfo": { "get": { "tags": [ "Share" ], "summary": "getCampFollowInfo", "description": "响应契约：SeriesInfo。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Share_getCampFollowInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/share/getCampItemInfo": { "get": { "tags": [ "Share" ], "summary": "getCampItemInfo", "description": "响应契约：SeriesInfo。\n\n需要登录。 需要请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Share_getCampItemInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/share/getCampLink": { "get": { "tags": [ "Share" ], "summary": "getCampLink", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Share_getCampLink", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/share/getSeriesInfo": { "get": { "tags": [ "Share" ], "summary": "落地页 - 获取剧集模板信息", "description": "返回分享落地页模板信息。\n\n响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Share_getSeriesTemplateInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "suid", "in": "query", "required": false, "description": "分享用户标识。", "schema": { "type": "string", "description": "分享用户标识。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/social/works/like": { "post": { "tags": [ "Social" ], "summary": "�", "description": "�容 ugc-api-go 点赞作品接口\nPOST /api/v1/social/works/like\nbody: {\"obj_id\": 123, \"obj_type\": 1}\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Social_likeWork", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "obj_id": { "type": "integer" }, "obj_type": { "type": "integer" } } } } } } } }, "/social/works/unlike": { "post": { "tags": [ "Social" ], "summary": "�", "description": "�容 ugc-api-go 取消点赞作品接口\nPOST /api/v1/social/works/unlike\nbody: [{\"obj_id\": 123, \"obj_type\": 1}]\n\n响应契约：ListPage。\n\n需要登录。 无需请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Social_unlikeWork", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/startTask": { "post": { "tags": [ "task" ], "summary": "开始任务", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_task_startTask", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "activity_type": { "type": "string" }, "task_id": { "type": "string" }, "is_sub_task": { "type": "integer" }, "sub_task_id": { "type": "string" } } } } } } } }, "/story/chapterList": { "get": { "tags": [ "Story" ], "summary": "Get Story Chapter List", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Story_getStoryChapterList", "parameters": [ { "name": "story_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/story/collect": { "post": { "tags": [ "Story" ], "summary": "Collect", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Story_collect", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "story_ids": { "type": "string" }, "is_collect": { "type": "integer" } } } } } } } }, "/story/delStoryHistory": { "post": { "tags": [ "Story" ], "summary": "Del Story History", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Story_delStoryHistory", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "story_ids": { "type": "string" } } } } } } } }, "/story/getCollectList": { "get": { "tags": [ "Story" ], "summary": "Get Collect List", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Story_getCollectList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/story/getWatchHistory": { "get": { "tags": [ "Story" ], "summary": "Get Watch History", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Story_getWatchHistory", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/story/like": { "post": { "tags": [ "Story" ], "summary": "Like", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Story_like", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "story_id": { "type": "integer" }, "is_like": { "type": "integer" } } } } } } } }, "/story/list": { "get": { "tags": [ "Story" ], "summary": "Get Story List", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Story_getStoryList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/story/reportStoryHistory": { "post": { "tags": [ "Story" ], "summary": "Report Story History", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Story_reportStoryHistory", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "story_id": { "type": "integer" }, "chapter_no": { "type": "integer" } } } } } } } }, "/story/unlock": { "post": { "tags": [ "Story" ], "summary": "Unlock", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Story_unlock", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "story_id": { "type": "integer" }, "chapter_id": { "type": "integer" } } } } } } } }, "/stripe/notify": { "post": { "tags": [ "Pay" ], "summary": "Strip 回调通知", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Pay_stripeNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/stripe/testSub": { "post": { "tags": [ "Pay" ], "summary": "Stripe Test Sub", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 需要登录。 需要请求签名。 响应会经过加密中间件。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "any_Pay_stripeTestSub", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "sub_id": { "type": "string" } } } } } } } }, "/submitFeedback": { "post": { "tags": [ "Feedback" ], "summary": "提交反馈", "description": "响应契约：EmptyObject。\n\n需要登录。 无需请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Feedback_submitFeedback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/submitRedeemCode": { "get": { "tags": [ "DirectToCustomer" ], "summary": "Submit Redeem Code", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_DirectToCustomer_submitRedeemCode", "parameters": [ { "name": "code", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/subscribeVip/getFullVipList": { "get": { "tags": [ "SubscribeVip" ], "summary": "获取�", "description": "��\n会员列表\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SubscribeVip_getFullVipList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/subscribeVip/getVipList": { "get": { "tags": [ "SubscribeVip" ], "summary": "获取会员列表(>=3.8.0)", "description": "响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SubscribeVip_getVipList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/subscribeVip/getVipListV2": { "get": { "tags": [ "SubscribeVip" ], "summary": "获取会员列表(>=4.6.4)", "description": "响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SubscribeVip_getVipListV2", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/subscribeVip/subscribeVip10TimesSign": { "post": { "tags": [ "SubscribeVip" ], "summary": "10倍�", "description": "周卡会员签到\n\n响应契约：SignResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_SubscribeVip_subscribeVip10TimesSign", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "prize_coin": 20, "bonus_expired_at": 1710000000, "sign_log": { "uid": 10001, "days": 2, "prize_coin": 20, "country": "US", "created_at": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/subscribeVip/subscribeVipCard": { "get": { "tags": [ "SubscribeVip" ], "summary": "订�", "description": "会员卡片\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SubscribeVip_subscribeVipCard", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/subscribeVip/subscribeVipSign": { "post": { "tags": [ "SubscribeVip" ], "summary": "订�", "description": "会员签到\n\n响应契约：SignResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_SubscribeVip_subscribeVipSign", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "prize_coin": 20, "bonus_expired_at": 1710000000, "sign_log": { "uid": 10001, "days": 2, "prize_coin": 20, "country": "US", "created_at": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "is_yesterday": { "type": "integer" } } } } } } } }, "/subscribeVip/subscribeVipSignList": { "get": { "tags": [ "SubscribeVip" ], "summary": "订�", "description": "会员签到列表\n\n响应契约：SignList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_SubscribeVip_subscribeVipSignList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "today_is_sign": 0, "list": [ { "day": 1, "is_sign": 1, "prize": 10 }, { "day": 2, "is_sign": 0, "prize": 20 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/swagger": { "get": { "tags": [ "Docs" ], "summary": "Swagger UI 页面", "description": "返回 Swagger UI 文档页面。认证要求：无需登录。", "operationId": "swaggerPage", "responses": { "200": { "description": "Swagger UI HTML", "content": { "text/html": { "schema": { "type": "string" } } } } } } }, "/task/getAdH5List": { "get": { "tags": [ "task" ], "summary": "H5广告", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_task_getAdH5List", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/task/getTaskCoins": { "get": { "tags": [ "task" ], "summary": "Get Task Coins", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_task_getTaskCoins", "parameters": [ { "name": "task_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "watch_num", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/task/getTaskTotalCoins": { "get": { "tags": [ "task" ], "summary": "获取任务总奖励", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_task_getTaskTotalCoins", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/task/isShowLoginAlert": { "post": { "tags": [ "task" ], "summary": "是否显示第三方登录弹窗", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_task_isShowLoginAlert", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/task/searchTask": { "post": { "tags": [ "task" ], "summary": "查询某个任务�", "description": "况\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_task_searchTask", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "task_id": { "type": "string" }, "is_sub_task": { "type": "integer" }, "sub_task_id": { "type": "string" }, "activity_type": { "type": "string" } } } } } } } }, "/taskV2/completeTask": { "post": { "tags": [ "taskV2" ], "summary": "Complete Task", "description": "响应契约：ListPage。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_taskV2_completeTask", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/taskV2/receiveTaskReward": { "post": { "tags": [ "taskV2" ], "summary": "预留接口", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_taskV2_receiveTaskReward", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/test": { "post": { "tags": [ "Health" ], "summary": "Test", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 响应会经过加密中间件。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "any_Health_test", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/test/dcdnTest": { "post": { "tags": [ "AliHls" ], "summary": "Dcdn Test", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_AliHls_dcdnTest", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/trailerLike": { "post": { "tags": [ "User" ], "summary": "预告片点赞/取消", "description": "响应契约：ActionResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_trailerLike", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ActionResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "result": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ActionResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "trailer_id": { "type": "string" }, "is_delete": { "type": "string" } } } } } } } }, "/turbolink/callback": { "post": { "tags": [ "Turbolink" ], "summary": "Turbolink 回调", "description": "接收 Turbolink 回调通知；当前无入参，固定返回处理成功状态。\n\n响应契约：SimpleMap。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Turbolink_callback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "ret": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/turbolink/deductBonus": { "post": { "tags": [ "Turbolink" ], "summary": "Deduct Bonus", "description": "响应契约：TurbolinkWebDeductBonus。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Turbolink_deductBonus", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebDeductBonus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "state": "success", "relate_id": "deduct_001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebDeductBonus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/turbolink/getUserInfo": { "post": { "tags": [ "Turbolink" ], "summary": "Get User Info", "description": "响应契约：TurbolinkWebUserInfo。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Turbolink_getUserInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebUserInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "coin_num": 100, "username": "demo_user", "avatar_url": "https://cdn.example.com/avatar.png" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebUserInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/turbolink/webCallback": { "post": { "tags": [ "Web TurboLink" ], "summary": "TurboLink Web 奖品发放回调", "description": "TurboLink 服务端在用户完成任务后回调本接口，为用户发放 Bonus 奖励。无需登录、无需 FlexTV 接口签名。鉴权方式：请求头 Authorization 固定为 Token {NOTIFY_TOKEN}，其中 NOTIFY_TOKEN 来自环境变量 TURBOLINK.NOTIFY_TOKEN。user_id 必须传 public_uid（HashId），不能传数字 uid。奖励金额从 kv_data 中解析，优先识别 SEO_Bonus、reward、bonus、Bonus，或 key 名包含 bonus 的字段；也可仅传 reward_num。成功返回纯文本 success，失败返回纯文本 fail（HTTP 均为 200）。\n\n响应契约：TurbolinkWebCallbackText。\n\n鉴权失败、body 非法、用户不存在、奖励金额<=0 或发奖失败时返回 fail。相同 task_id 重复回调时幂等返回 success。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_web_Turbolink_webCallback", "parameters": [ { "name": "Authorization", "in": "header", "required": true, "description": "鉴权头，格式：Token {NOTIFY_TOKEN}。", "schema": { "type": "string", "description": "鉴权头，格式：Token {NOTIFY_TOKEN}。" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "固定为 application/json。", "schema": { "type": "string", "description": "固定为 application/json。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebCallbackText" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": "success", "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebCallbackText" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "user_id": { "type": "string", "description": "用户 public_uid。" }, "task_id": { "type": "string", "description": "任务/活动唯一 ID，用于幂等去重。" }, "reward_num": { "type": "integer", "description": "奖励倍数，默认 1。" }, "user_platform": { "type": "string", "description": "用户平台，如 web、web-pc、android、ios。" }, "kv_data": { "type": "object", "description": "奖励配置，如 reward 或 SEO_Bonus 字段。" } }, "required": [ "user_id" ] } } } } } }, "/turbolink/webDeductBonus": { "post": { "tags": [ "Web TurboLink" ], "summary": "TurboLink Web 积分扣减/兑换回调", "description": "TurboLink 活动内积分扣减或兑换时回调本接口。无需登录、无需 FlexTV 接口签名。鉴权方式：Authorization 为 Token 或 Bearer + 签名，签名算法 md5(OPEN_SECRET + ' ' + md5(原始请求体))，OPEN_SECRET 来自环境变量 TURBOLINK.OPEN_SECRET。state=deduct 时扣减 Bonus；state=gain 时发放 Bonus。user_id 必须传 public_uid。\n\n响应契约：TurbolinkWebDeductBonus。\n\n鉴权失败返回 code=401；业务失败（余额不足、用户不存在等）返回 code=200 且 state=lack。幂等重复请求返回 state=success。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_web_Turbolink_webDeductBonus", "parameters": [ { "name": "Authorization", "in": "header", "required": true, "description": "鉴权头，格式：Bearer {sign} 或 Token {sign}，sign=md5(OPEN_SECRET + ' ' + md5(body))。", "schema": { "type": "string", "description": "鉴权头，格式：Bearer {sign} 或 Token {sign}，sign=md5(OPEN_SECRET + ' ' + md5(body))。" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "固定为 application/json。", "schema": { "type": "string", "description": "固定为 application/json。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebDeductBonus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "state": "success", "relate_id": "deduct_001" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebDeductBonus" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "user_id": { "type": "string", "description": "用户 public_uid。" }, "state": { "type": "string", "description": "操作类型：deduct=扣减积分，gain=发放积分。" }, "num": { "type": "integer", "description": "积分数量，必须大于 0。" }, "deduct_id": { "type": "string", "description": "扣减幂等 ID，state=deduct 时建议传入。" }, "gain_id": { "type": "string", "description": "发放幂等 ID，state=gain 时建议传入。" }, "user_platform": { "type": "string", "description": "用户平台，如 web、web-pc。" } }, "required": [ "user_id", "state", "num" ] } } } } } }, "/turbolink/webGetUserInfo": { "post": { "tags": [ "Web TurboLink" ], "summary": "TurboLink Web 查询用户 Bonus 余额", "description": "TurboLink 活动页展示用户积分时回调本接口，实时查询用户 Bonus 余额及基础资料。无需登录、无需 FlexTV 接口签名。鉴权方式与 webDeductBonus 相同：Authorization 为 Bearer 或 Token + 签名 sign=md5(OPEN_SECRET + ' ' + md5(原始请求体))。user_id 必须传 public_uid。返回结构与 APP 端 turbolink/getUserInfo 一致。\n\n响应契约：TurbolinkWebUserInfo。\n\n鉴权失败或用户不存在时返回 code=200 且 data 为空对象 {}。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_web_Turbolink_webGetUserInfo", "parameters": [ { "name": "Authorization", "in": "header", "required": true, "description": "鉴权头，格式：Bearer {sign} 或 Token {sign}，sign=md5(OPEN_SECRET + ' ' + md5(body))。", "schema": { "type": "string", "description": "鉴权头，格式：Bearer {sign} 或 Token {sign}，sign=md5(OPEN_SECRET + ' ' + md5(body))。" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "固定为 application/json。", "schema": { "type": "string", "description": "固定为 application/json。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebUserInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "coin_num": 100, "username": "demo_user", "avatar_url": "https://cdn.example.com/avatar.png" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TurbolinkWebUserInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "user_id": { "type": "string", "description": "用户 public_uid。" } }, "required": [ "user_id" ] } } } } } }, "/tvLogin": { "post": { "tags": [ "Auth" ], "summary": "tv端登录", "description": "响应契约：EmptyObject。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_tvLogin", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/txTranscodingCallback": { "post": { "tags": [ "Tencent" ], "summary": "Tx Transcoding Callback", "description": "响应契约：ListPage。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Tencent_txTranscodingCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/unsubscribe": { "post": { "tags": [ "Email" ], "summary": "One Click Unsubscribe", "description": "响应契约：EmptyObject。\n\n路由声明为 any，文档统一按 POST 展示。 无需登录。 无需请求签名。 返回明文响应。\n\n路由声明：服务端允许任意 HTTP 方法访问，文档以 POST 形式展示。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "any_Email_oneClickUnsubscribe", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/user/fullInEmail": { "post": { "tags": [ "User" ], "summary": "补�", "description": "为当前用户补充或绑定邮箱地址。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_fullInEmail", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" } }, "required": [ "email" ] } } } } } }, "/user/getBonusHistory": { "get": { "tags": [ "User" ], "summary": "bonus列表", "description": "返回 App 端 bonus 流水列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getBonusHistory", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/getSignList": { "get": { "tags": [ "User" ], "summary": "获取签到列表", "description": "返回当前用户的签到状态与奖励配置。\n\n响应契约：SignList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getSignList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "today_is_sign": 0, "list": [ { "day": 1, "is_sign": 1, "prize": 10 }, { "day": 2, "is_sign": 0, "prize": 20 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/getSpendingList": { "get": { "tags": [ "User" ], "summary": "消耗列表", "description": "返回 App 端消费记录列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getSpendingList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/getTopUpList": { "get": { "tags": [ "User" ], "summary": "�", "description": "返回 App 端充值记录列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_getTopUpList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/notificationPermissions": { "post": { "tags": [ "User" ], "summary": "更新通知权限状态", "description": "上报当前用户的系统通知权限状态。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_notificationPermissions", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "notification_permissions": { "type": "integer", "description": "通知权限状态码。" } }, "required": [ "notification_permissions" ] } } } } } }, "/user/positiveVoteAlert": { "get": { "tags": [ "User" ], "summary": "好评弹窗判断", "description": "判断当前用户是否需要展示好评弹窗。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_positiveVoteAlert", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/sign": { "get": { "tags": [ "User" ], "summary": "执行签到", "description": "完成当前用户的签到动作并返回签到结果。\n\n响应契约：SignResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_sign", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "prize_coin": 20, "bonus_expired_at": 1710000000, "sign_log": { "uid": 10001, "days": 2, "prize_coin": 20, "country": "US", "created_at": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/user/signNotice": { "post": { "tags": [ "User" ], "summary": "更新签到提醒设置", "description": "配置当前用户是否接收签到提醒。\n\n响应契约：SignResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_signNotice", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "prize_coin": 20, "bonus_expired_at": 1710000000, "sign_log": { "uid": 10001, "days": 2, "prize_coin": 20, "country": "US", "created_at": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "is_sign_notice": { "type": "integer", "description": "1 表示开启，0 表示关闭。" } }, "required": [ "is_sign_notice" ] } } } } } }, "/user/switchLang": { "post": { "tags": [ "User" ], "summary": "用户切换语言", "description": "更新当前用户的语言偏好。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_User_switchLang", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "lang": { "type": "string", "description": "目标语言代码。" } }, "required": [ "lang" ] } } } } } }, "/userV2/getSignList": { "get": { "tags": [ "UserV2" ], "summary": "Get Sign List", "description": "响应契约：SignList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_UserV2_getSignList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "today_is_sign": 0, "list": [ { "day": 1, "is_sign": 1, "prize": 10 }, { "day": 2, "is_sign": 0, "prize": 20 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/userV2/sign": { "get": { "tags": [ "UserV2" ], "summary": "Sign", "description": "响应契约：SignResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_UserV2_sign", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "prize_coin": 20, "bonus_expired_at": 1710000000, "sign_log": { "uid": 10001, "days": 2, "prize_coin": 20, "country": "US", "created_at": 1710000000 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SignResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/verifyResetPasswordCode": { "post": { "tags": [ "Auth" ], "summary": "验证重置密码验证码", "description": "校验找回密码流程中的验证码是否有效。\n\n响应契约：EmptyObject。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_verifyResetPasswordCode", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "邮箱地址。" }, "code": { "type": "string", "description": "邮箱验证码。" } }, "required": [ "email", "code" ] } } } } } }, "/video/getPlayList": { "get": { "tags": [ "Video" ], "summary": "获取授权播放链接(获取�", "description": "返回免费剧集播放列表。\n\n响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Video_getPlayList", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/visitorRegister": { "post": { "tags": [ "Auth" ], "summary": "访客注册（登录）", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_visitorRegister", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/web/auth/login": { "post": { "tags": [ "Auth" ], "summary": "web端访客注册（登录）", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_webVisitorRegister", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/web/auth/loginByUid": { "post": { "tags": [ "Auth" ], "summary": "使用uid登陆", "description": "响应契约：AuthResult。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_Auth_webLoginByUid", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "uid": { "type": "string" }, "login_uid": { "type": "string" } } } } } } } }, "/web/auth/logout": { "post": { "tags": [ "Auth" ], "summary": "账号退出登录", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_webLogout", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/web/authRegister": { "post": { "tags": [ "Auth" ], "summary": "web端授权注册（登录）", "description": "响应契约：AuthResult。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_Auth_webAuthRegister", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "token": "token_demo_123", "uid": 10001, "account_type": 1, "country_code": "US", "openid": "openid_demo", "name": "Demo User", "avatar": "https://cdn.flextv.com/avatar.png", "gender": 0, "email": "demo@example.com", "refresh_token": "refresh_token_demo" }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/AuthResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/web/checkIp": { "get": { "tags": [ "Auth" ], "summary": "web端检查是否中国IP", "description": "响应契约：SimpleMap。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Auth_checkWebIp", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "data": true }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/web/index": { "get": { "tags": [ "WebIndex" ], "summary": "首页楼层列表", "description": "返回 Web 首页聚合数据。该接口已废弃，仅供旧端兼容；新端请改用 /web/index/banner 和 /web/index/floor。\n\n响应契约：IndexFloorList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_getIndexFloorListV2", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "nav_id", "in": "query", "required": false, "description": "导航 ID。", "schema": { "type": "integer", "description": "导航 ID。" } }, { "name": "refresh_history", "in": "query", "required": false, "description": "是否刷新历史标记。", "schema": { "type": "integer", "description": "是否刷新历史标记。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "nav": [ { "nav_id": 1, "nav_name": "Home" } ], "banner": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001 } ], "floor": [ { "title": "Popular", "url_title": "popular", "template_type": 1, "list": [] } ], "paging": { "page_no": 1, "page_size": 20, "total": 0 }, "list": [] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/IndexFloorList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "deprecated": true } }, "/web/index/banner": { "get": { "tags": [ "WebIndex" ], "summary": "首页 banner 列表", "description": "返回 Web 首页 banner 列表，新端应优先调用该接口。\n\n响应契约：HomeBannerList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_getHomeBanner", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomeBannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "title": "Featured", "image": "https://cdn.flextv.com/banner.jpg", "jump_type": 1, "link": "https://www.flextv.cc", "series_id": 1001, "description": "Drama description", "tags": [ { "tag_id": 81, "tag_name": "Future", "url_title": "Future", "web_tag_id": "wym0wzej9" } ] } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomeBannerList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/web/index/floor": { "get": { "tags": [ "WebIndex" ], "summary": "首页楼层摘要列表", "description": "返回 Web 首页多个楼层的首屏摘要列表，新端应优先调用该接口。\n\n响应契约：HomeFloorSummaryList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_getHomeFloorSummary", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "nav_id", "in": "query", "required": false, "description": "导航 ID。", "schema": { "type": "integer", "description": "导航 ID。" } }, { "name": "refresh_history", "in": "query", "required": false, "description": "是否刷新历史标记。", "schema": { "type": "integer", "description": "是否刷新历史标记。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomeFloorSummaryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "floor_id": 11, "title": "Popular", "url_title": "popular", "template_type": 1, "has_more": 1, "list": [] } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HomeFloorSummaryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webAdUnlockIsSuccess": { "get": { "tags": [ "WebSeries" ], "summary": "用于判断广告解锁是否成功", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_adUnlockIsSuccess", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "section_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webBatchSeriesCollectStatus": { "get": { "tags": [ "WebSeries" ], "summary": "Batch Series Collect Status", "description": "响应契约：StatusMap。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_batchSeriesCollectStatus", "parameters": [ { "name": "series_ids", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/StatusMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "web_series_1": 1, "web_series_2": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/StatusMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webBatchSeriesLikeStatus": { "get": { "tags": [ "WebSeries" ], "summary": "批量获取用户对剧的点赞状态（map：web_series_id 加密串 => is_like）", "description": "�\n�参 series_ids 为 web 端加密的 series_id，逗号分隔或数组\n\n响应契约：StatusMap。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_batchSeriesLikeStatus", "parameters": [ { "name": "series_ids", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/StatusMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "web_series_1": 1, "web_series_2": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/StatusMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webCollect": { "post": { "tags": [ "CollectAndHistory" ], "summary": "web端追剧接口", "description": "Web 端新增或取消剧集收藏，并返回最新收藏数展示值。\n\n响应契约：CollectResult。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_CollectAndHistory_webCollect", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "series_id": 1001, "collect_num_str": "88" } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectResult" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "剧集 ID，可为单个或批量标识。" }, "is_delete": { "type": "integer", "description": "1 表示取消收藏，0 表示收藏。" } }, "required": [ "series_id" ] } } } } } }, "/webCollectList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "web端收藏历史", "description": "返回 Web 端收藏列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_webGetCollectList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webDelHistory": { "post": { "tags": [ "CollectAndHistory" ], "summary": "web端删除观看历史", "description": "删除 Web 端指定剧集的观看历史。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_CollectAndHistory_webDelHistory", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "剧集 ID。" } }, "required": [ "series_id" ] } } } } } }, "/webGetPlayInfo": { "get": { "tags": [ "Video" ], "summary": "web端获取授权播放链接", "description": "返回 Web 端授权播放链接与剧封面 cover。该接口无需登录。\n\n响应契约：SeriesInfo。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_Video_webGetPlayInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "section_id", "in": "query", "required": false, "description": "分集 ID，默认 0。", "schema": { "type": "integer", "description": "分集 ID，默认 0。" } }, { "name": "series_no", "in": "query", "required": false, "description": "分集序号，默认 0；与 section_id 二选一，section_id 优先。", "schema": { "type": "integer", "description": "分集序号，默认 0；与 section_id 二选一，section_id 优先。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetSeriesDetailContent": { "get": { "tags": [ "WebSeries" ], "summary": "Web 端获取剧集详�", "description": "返回详情页内容态数据，适合详情页首屏展示。\n\n响应契约：SeriesDetailContent。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesDetailContent", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesDetailContent" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_id_origin": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "series_status": 1, "description": "Demo description", "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "like_num_str": "12", "last_series_no": 24, "current_series_no": 1, "current_range_id": 1, "recently_series_no": 1, "video_duration": "01:30", "tag_ids": "1,2", "series_level": 1, "trial_time": 300, "release_protection": 0, "lang": "en", "director": "Director", "writer": "Writer", "starring": "Actor A, Actor B", "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "unit_price": 10, "progress": "UPDATE_TO_EPISODE_24" }, "tag": [ { "tag_id": 1, "tag_name": "Romance", "web_tag_id": "web_tag_1" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesDetailContent" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetSeriesInfo": { "get": { "tags": [ "WebSeries" ], "summary": "获取剧集信息", "description": "响应契约：SeriesInfo。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesInfo", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webGetSeriesLang": { "get": { "tags": [ "WebSeries" ], "summary": "获取剧集的语言版本", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesLang", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webGetSeriesLangName": { "get": { "tags": [ "WebSeries" ], "summary": "获取剧集各语言的 series_name 映射", "description": "响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesLangName", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webGetSeriesSectionContentList": { "get": { "tags": [ "WebSeries" ], "summary": "Get Series Section Content List", "description": "响应契约：SeriesSectionContentList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesSectionContentList", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "source", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionContentList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_id_origin": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "series_status": 1, "description": "Demo description", "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "like_num_str": "12", "last_series_no": 24, "current_series_no": 1, "current_range_id": 1, "recently_series_no": 1, "video_duration": "01:30", "tag_ids": "1,2", "series_level": 1, "trial_time": 300, "release_protection": 0, "lang": "en", "director": "Director", "writer": "Writer", "starring": "Actor A, Actor B", "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "unit_price": 10, "progress": "UPDATE_TO_EPISODE_24" }, "range_size": 20, "range_list": [ { "range_id": 1, "start_series_no": 1, "end_series_no": 20 } ], "list": [ { "id": 1, "series_id": 1001, "series_no": 1, "video_id": 2001, "is_charge": 0, "unit_price": 0, "like_num": 12, "like_num_str": "12", "watch_num": "1.2K", "has_pay": 1, "is_like": 1, "cover": "https://cdn.flextv.com/series.jpg", "summary": "Episode 1 summary", "video_duration": 120, "publish_time": 1710000000, "lang": "en" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionContentList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetSeriesSectionFullList": { "get": { "tags": [ "WebSeries" ], "summary": "Web 端获取剧集选集全集列表", "description": "返回 Web 端选集面板所需的完整数据集，默认无需登录，但仍可能受签名与响应保护约束。响应中的 tag 为当前剧集关联标签，is_primary=1 表示一级分类（题材/Genre）。\n\n响应契约：ListPage。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesSectionFullListV2", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "series_no", "in": "query", "required": false, "description": "当前集数，用于定位默认选中项。", "schema": { "type": "integer", "description": "当前集数，用于定位默认选中项。" } }, { "name": "source", "in": "query", "required": false, "description": "来源标识。", "schema": { "type": "integer", "description": "来源标识。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "series_id": 1001, "series_name": "Example Drama" }, "tag": [ { "tag_id": 12, "tag_name": "Romance", "url_title": "romance", "web_tag_id": "abc123", "group_type": 2, "group_name": "Genre", "is_primary": 1 } ], "list": [], "play_info": { "video_url": "", "progressive": [], "subtitle": [], "is_trial": 0, "duration": 0, "upload_date": 0 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetSeriesSectionUserState": { "get": { "tags": [ "WebSeries" ], "summary": "Get Series Section User State", "description": "响应契约：SeriesSectionStateList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesSectionUserState", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionStateList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "id": 1, "series_id": 1001, "series_no": 1, "is_like": 1, "has_pay": 1 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesSectionStateList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetSeriesUserState": { "get": { "tags": [ "WebSeries" ], "summary": "Get Series User State", "description": "响应契约：SeriesUserState。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Series_getSeriesUserState", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "series_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesUserState" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "is_like": 1, "is_collect": 1, "has_unlock_history": 1, "max_can_play_series_no": 24, "current_series_no": 1 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesUserState" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagAll": { "get": { "tags": [ "WebIndex" ], "summary": "Web 全部标签聚合页", "description": "返回当前请求语言下的分页标签列表。列表由系统内容标签和 Web 自定义标签组成：系统内容标签固定排在前面，仅返回当前有已上架短剧实际使用且具有 URL slug 的标签，按标签创建时间倒序；Web 自定义标签排在系统标签之后，仅返回已上架、未删除、已开启“全部标签页显示”且具有 URL slug 的标签，按后台权重倒序、创建时间倒序。英文详情页地址拼接为 /genres/{url_title}-{web_tag_id}，非英文地址在前面增加语言路径 /{lang}/genres/{url_title}-{web_tag_id}；不要直接使用内部 tag_id 生成 URL。\n\n响应契约：TagPageList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagAll", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，从 1 开始；不传或小于 1 时按 1 处理。", "schema": { "type": "integer", "description": "页码，从 1 开始；不传或小于 1 时按 1 处理。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页标签数，默认 72，最大 100；小于等于 0 时按 72 处理。", "schema": { "type": "integer", "description": "每页标签数，默认 72，最大 100；小于等于 0 时按 72 处理。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagPageList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 72, "total": 120 }, "list": [ { "tag_id": 135, "tag_name": "Fantasy", "url_title": "fantasy", "web_tag_id": "x8d2m6q9" }, { "tag_id": 144, "tag_name": "Urban Life", "url_title": "urban-life", "web_tag_id": "pjy82pmz24" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagPageList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagData": { "get": { "tags": [ "WebIndex" ], "summary": "获取标签剧集", "description": "返回标签下的分页剧集列表。\n\n响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagData", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 10。", "schema": { "type": "integer", "description": "每页条数，默认 10。" } }, { "name": "url_title", "in": "query", "required": false, "description": "URL 标题。", "schema": { "type": "string", "description": "URL 标题。" } }, { "name": "web_tag_ids", "in": "query", "required": false, "description": "Web 标签 ID 列表，逗号分隔；多个标签按 AND 条件筛选。", "schema": { "type": "string", "description": "Web 标签 ID 列表，逗号分隔；多个标签按 AND 条件筛选。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagDetail": { "get": { "tags": [ "WebIndex" ], "summary": "Web 标签详情页", "description": "返回当前请求语言下的标签头部信息、后台 TDK、关联标签和分页短剧列表，同时兼容系统内容标签与 Web 自定义标签。tag_info.is_custom_tag 标识标签类型：1 为 Web 自定义标签，0 为系统内容标签。Web 自定义标签仅在已上架且未删除时可访问，“全部标签页显示”开关只影响 /webGetTagAll，不影响已上架标签通过详情链接直接访问。TDK 优先返回后台配置的 Title、Description、Keywords，未配置的字段使用系统默认值。自定义标签短剧按后台绑定权重倒序，系统内容标签短剧按上架时间倒序。关联标签仅返回同语言、已上架的 Web 自定义标签，按创建时间倒序；完整名称中当前标签作为独立词出现时，tag_name 删除该独立词，否则原样返回，点击时使用该项的 url_title 和 web_tag_id 进入其完整标签详情页。受国家版权过滤影响，单页 list 数量可能少于 page_size。\n\n响应契约：TagDetail。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagDetail", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，从 1 开始；默认 1。", "schema": { "type": "integer", "description": "页码，从 1 开始；默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页短剧数，默认 10，最大 100；小于等于 0 时按 10 处理。", "schema": { "type": "integer", "description": "每页短剧数，默认 10，最大 100；小于等于 0 时按 10 处理。" } }, { "name": "url_title", "in": "query", "required": false, "description": "标签 slug 或完整详情页 slug，例如 urban1 或 urban1-pjy82pmz24；与 web_tag_id 至少传一个，建议前端传完整 slug。", "schema": { "type": "string", "description": "标签 slug 或完整详情页 slug，例如 urban1 或 urban1-pjy82pmz24；与 web_tag_id 至少传一个，建议前端传完整 slug。" } }, { "name": "web_tag_id", "in": "query", "required": false, "description": "标签对外 hash ID，例如 pjy82pmz24；请求中间件会解码为内部 tag_id。与 url_title 至少传一个。", "schema": { "type": "string", "description": "标签对外 hash ID，例如 pjy82pmz24；请求中间件会解码为内部 tag_id。与 url_title 至少传一个。" } }, { "name": "tag_id", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagDetail" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "tag_info": { "tag_id": 144, "tag_name": "work", "url_title": "work", "web_tag_id": "pjy82pmz24", "is_custom_tag": 1, "title": "Work Short Dramas | FlexTV", "description": "Discover short dramas about work on FlexTV.", "keywords": "work,short drama,FlexTV", "series_total": 3 }, "related_tags": [ { "tag_id": 146, "tag_name": "good", "url_title": "good-work", "web_tag_id": "q7n3k9x2" }, { "tag_id": 145, "tag_name": "what", "url_title": "what-work", "web_tag_id": "v4m8p2d6" } ], "paging": { "page_no": 1, "page_size": 10, "total": 3 }, "list": [ { "series_id": 1001, "series_name": "Get Rich, Agent Mom!", "description": "A gripping tale of revenge and redemption.", "cover": "https://cdn.flextv.com/series/cover.jpg", "serial_status": 1, "video_type": 1, "section_num": 80, "section_id": 90001, "show_video_type": 0, "icon_type": 0, "icon_text": "", "collect_num": 1288, "collect_num_str": "1.2K", "watch_num_int": 56000, "watch_num_str": "56K", "tag": [ { "tag_id": 2, "tag_name": "Time Travel", "url_title": "time-travel", "web_tag_id": "web_tag_2" }, { "tag_id": 5, "tag_name": "Family", "url_title": "family", "web_tag_id": "web_tag_5" } ] } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagDetail" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagLang": { "get": { "tags": [ "WebIndex" ], "summary": "获取标签剧集", "description": "返回标签对应的语言维度数据。\n\n响应契约：TagList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagLang", "parameters": [ { "name": "url_title", "in": "query", "required": false, "description": "URL 标题。", "schema": { "type": "string", "description": "URL 标题。" } }, { "name": "tag_id", "in": "query", "required": false, "description": "标签 ID。", "schema": { "type": "integer", "description": "标签 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "tag_id": 1, "tag_name": "Romance", "url_title": "romance", "web_tag_id": "m8k2p4z6" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagList": { "get": { "tags": [ "WebIndex" ], "summary": "获取标签列表", "description": "返回 Web 标签页主标签/次标签分组列表。\n\n响应契约：TagCategoryList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagCategoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "primary": [ { "group_type": 2, "group_name": "Genre", "list": [ { "tag_id": 135, "tag_name": "Fantasy", "url_title": "fantasy", "web_tag_id": "web_tag_135" } ] } ], "secondary": [ { "group_type": 3, "group_name": "Plot", "list": [ { "tag_id": 21, "tag_name": "Revenge", "url_title": "revenge", "web_tag_id": "web_tag_21" } ] } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/TagCategoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetTagSeries": { "get": { "tags": [ "WebIndex" ], "summary": "获取标签对应前两部短剧", "description": "返回标签对应的前两部短剧。\n\n响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webGetTagSeries", "parameters": [ { "name": "tag_id", "in": "query", "required": true, "description": "标签 ID。", "schema": { "type": "integer", "description": "标签 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webGetUrlInfo": { "get": { "tags": [ "WebCommon" ], "summary": "查询当前页面 URL 对应的永�", "description": "重定向地址。\n\n响应契约：SeriesInfo。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_web_Common_getUrlInfo", "parameters": [ { "name": "url", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webHistoryList": { "get": { "tags": [ "CollectAndHistory" ], "summary": "web端观看历史", "description": "返回 Web 端观看历史列表。\n\n响应契约：CollectHistoryList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_webGetHistoryList", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "series_name": "Demo Series", "cover": "https://cdn.flextv.com/series.jpg", "watch_num": "1.2K", "collect_num_str": "88", "last_series_no": 24 } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CollectHistoryList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webHotTags": { "get": { "tags": [ "WebTag" ], "summary": "热门标签", "description": "返回当前语言体系下 30 日标签点击 UV 最高的标签列表，固定默认 10 个。统计来源为 ft_ods_web_event，event_id=600017，scene=browse；统计指标为标签点击 UV，不返回 click_pv；统计周期为近 30 天且不含当天。\n\n响应契约：HotTagList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_webHotTags", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "返回数量，默认 10，最大 20。", "schema": { "type": "integer", "description": "返回数量，默认 10，最大 20。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HotTagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "tag_id": 24, "tag_name": "Fantasy", "url_title": "Fantasy", "web_tag_id": "web_tag_24", "rank_no": 1, "click_uv": 15247 }, { "tag_id": 13, "tag_name": "Sweet Love", "url_title": "Sweet-Love", "web_tag_id": "web_tag_13", "rank_no": 2, "click_uv": 13002 } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/HotTagList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webHotWords": { "get": { "tags": [ "WebSearch" ], "summary": "Hot Words", "description": "响应契约：KeywordList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Search_hotWords", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/KeywordList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ "romance", "action", "drama" ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/KeywordList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webLikeSeries": { "post": { "tags": [ "WebUgcWork" ], "summary": "Web 点赞作品，转发到 UGC 网�", "description": "�\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_UgcWork_likeWork", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webMoreRecommended": { "get": { "tags": [ "WebIndex" ], "summary": "more recommended 模块：�", "description": "返回 Web more recommended 模块的短剧列表。\n\n响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Index_getMoreRecommended", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 18。", "schema": { "type": "integer", "description": "每页条数，默认 18。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webRankingRecommend": { "get": { "tags": [ "WebRecommend" ], "summary": "Ranking Recommend", "description": "响应契约：RankingList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Recommend_rankingRecommend", "parameters": [ { "name": "type", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "number", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/RankingList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "ranking_tab": [ { "rank_tab_id": 1, "rank_tab_name": "Top", "lang": "en" } ], "ranking_list": [ { "rank_tab_id": 1, "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "series_topic": "", "show_video_type": 0, "icon_type": 0, "icon_text": "", "icon_color": "", "icon": "", "tag_list": [ "Romance" ], "tag": "Romance" } ], "paging": { "page_no": 1, "page_size": 20, "total": 1 } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/RankingList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webRecommendNextSeriesInfo": { "get": { "tags": [ "WebRecommend" ], "summary": "推荐下一部剧集信息", "description": "响应契约：SeriesCardList。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Recommend_recommendNextSeriesInfo", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webRecommendedForYou": { "get": { "tags": [ "Web Recommend" ], "summary": "Recommended For You", "description": "返回 Web Recommended For You 模块短剧列表。该接口独立于 webYouMayLike：优先取当前语种官网近 7 日充值榜，不足时用官网近 30 日充值榜补齐，仍不足时用当前语种全量上架短剧兜底；PC/Web 固定最多返回 14 部，H5/WAP 固定最多返回 15 部。\n\n响应契约：SeriesCardArray。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Recommend_recommendedForYou", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前短剧 ID，传入后会从推荐结果中排除当前短剧。", "schema": { "type": "integer", "description": "当前短剧 ID，传入后会从推荐结果中排除当前短剧。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardArray" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "section_num": 24, "tag": "Romance" } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardArray" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webRecordHistory": { "get": { "tags": [ "CollectAndHistory" ], "summary": "web端记录看过的视频", "description": "记录 Web 端用户观看进度。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_CollectAndHistory_webRecordHistory", "parameters": [ { "name": "section_id", "in": "query", "required": true, "description": "分集 ID。", "schema": { "type": "integer", "description": "分集 ID。" } }, { "name": "duration", "in": "query", "required": false, "description": "当前播放时长，单位秒。", "schema": { "type": "integer", "description": "当前播放时长，单位秒。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webReportData": { "post": { "tags": [ "WebLog" ], "summary": "Report Data", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_web_Log_reportData", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "report_data": { "type": "string" } } } } } } } }, "/webResource/positions": { "get": { "tags": [ "Web Resource" ], "summary": "Web 获取官网资源位投放", "description": "返回官网各资源位的投放配置，按资源位编码平铺在 data 下。允许未登录访问；若投放配置了用户分层，则仅命中分层的登录用户可见。\\n\\n**后端自动处理（无需传参）**\\n- 端口：由请求头 appId 识别（WEB=PC，WAP=MobileWeb）\\n- 语言：由请求头 lang 识别\\n- 跳转链接：jump_url 由国家消费档位自动解析（default/test/T1/T2/T3）\\n\\n**去重规则**\\n同一语言、端口、资源位、跳转类型仅返回权重最高的一条。\\n\\n**页面展示**\\n接口不按 page_code 过滤，响应中的 page_codes 供前端按当前页面自行判断是否展示；page_codes 为空数组表示不限页面。\\n\\n无投放时对应资源位返回 null，前端应隐藏且不占位。\n\n响应契约：ResourcePositionMap。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_ResourcePosition_getList", "parameters": [ { "name": "slot_code", "in": "query", "required": false, "description": "指定资源位编码，不传则返回全部资源位。可选值：incentive_task_nav=激励任务导航，banner_bottom_bar=底部 Banner 条，card_float=卡片浮窗，profile_homepage=个人中心首页资源位。", "schema": { "type": "string", "description": "指定资源位编码，不传则返回全部资源位。可选值：incentive_task_nav=激励任务导航，banner_bottom_bar=底部 Banner 条，card_float=卡片浮窗，profile_homepage=个人中心首页资源位。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ResourcePositionMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "incentive_task_nav": null, "banner_bottom_bar": null, "card_float": { "id": 1001, "slot_code": "card_float", "resource_name": "Rewards", "title": "Rewards", "icon": "https://cdn.example.com/icon.png", "icon_type": "image", "tip": "", "jump_type": "turbolink_task_center", "jump_config": { "default": "https://example.com/task", "T1": "https://example.com/task?t1" }, "jump_url": "https://example.com/task?t1", "scene_tag": "T1", "page_codes": [ "index", "play" ], "weight": 100 }, "profile_homepage": null }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ResourcePositionMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSearch": { "get": { "tags": [ "WebSearch" ], "summary": "Search", "description": "响应契约：SeriesCardList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Search_search", "parameters": [ { "name": "keyword", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "page_no", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "page_size", "in": "query", "required": false, "description": "", "schema": { "type": "integer" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSeriesComment/deleteComment": { "post": { "tags": [ "Web Comment" ], "summary": "Web 删除评论", "description": "登录用户删除自己发布的评论。series_id 为 Web 端加密剧集 ID。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_Comment_deleteSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "Web 端加密剧集 ID。" }, "video_type": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" }, "comment_id": { "type": "integer", "description": "评论 ID。" } }, "required": [ "series_id", "comment_id" ] } } } } } }, "/webSeriesComment/likeComment": { "post": { "tags": [ "Web Comment" ], "summary": "Web 点赞或取消点赞评论", "description": "登录用户点赞或取消点赞指定评论。series_id 为 Web 端加密剧集 ID。\n\n响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_Comment_likeSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "Web 端加密剧集 ID。" }, "video_type": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" }, "comment_id": { "type": "integer", "description": "评论 ID。" }, "is_like": { "type": "integer", "description": "1 点赞，0 取消点赞。" } }, "required": [ "series_id", "comment_id", "is_like" ] } } } } } }, "/webSeriesComment/parentCommentDetail": { "get": { "tags": [ "Web Comment" ], "summary": "Web 获取父评论详情", "description": "返回指定父评论的详情，字段与 parentCommentList 单条评论一致，便于前端复用评论组件。series_id、web_comment_id 分别为 Web 端加密剧集 ID 与加密评论 ID，由 WebRequest 中间件自动解码。允许未登录访问，未登录时 is_like 默认为 0；video_type=6 时走广告评论数据源。响应 detail 含 web_comment_id、评论人/被回复人信息、点赞与子评论数等字段，sub_comment 在详情接口固定返回空对象。\n\n响应契约：SimpleMap。\n\nseries_id 缺失/非法，或 web_comment_id 缺失/解码失败时返回 code=10001；普通剧集父评论不存在、已删除或为人工评论时返回 code=10008。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Comment_seriesParentCommentDetail", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "Web 端加密剧集 ID。", "schema": { "type": "string", "description": "Web 端加密剧集 ID。" } }, { "name": "web_comment_id", "in": "query", "required": true, "description": "Web 端加密父评论 ID，由 WebRequest 中间件解码为内部 comment_id。", "schema": { "type": "string", "description": "Web 端加密父评论 ID，由 WebRequest 中间件解码为内部 comment_id。" } }, { "name": "video_type", "in": "query", "required": false, "description": "视频类型，普通剧集可不传；广告评论传 6。", "schema": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" } }, { "name": "display_scene", "in": "query", "required": false, "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。", "schema": { "type": "string", "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。" } }, { "name": "comment_id", "in": "query", "required": false, "description": "", "schema": { "type": "string" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "id": 101, "web_comment_id": "abc123def0", "parent_comment_id": 0, "from_uid": 12345, "from_avatar": "https://cdn.example.com/avatar.png", "from_nick_name": "User", "from_is_visitor": 0, "to_uid": 0, "to_avatar": "", "to_nick_name": "", "series_id": 1001, "series_no": 3, "comment_content": "Great episode", "like_num": 8, "sub_comment_num": 2, "is_like": 0, "is_manual_comment": 0, "is_reply_parent": 1, "comment_time": 1716000000, "community": [], "sub_comment": [] } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSeriesComment/parentCommentList": { "get": { "tags": [ "Web Comment" ], "summary": "Web 获取分集父评论列表", "description": "返回指定剧集、指定集数下的父评论列表。series_id 为 Web 端加密剧集 ID，会由 WebRequest 中间件解码；父评论按点赞数降序、发布时间降序排列。列表接口允许未登录访问，未登录时 is_like 默认按 0 处理。\n\n响应契约：ListPage。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Comment_seriesParentCommentList", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "Web 端加密剧集 ID。", "schema": { "type": "string", "description": "Web 端加密剧集 ID。" } }, { "name": "video_type", "in": "query", "required": false, "description": "视频类型，普通剧集可不传；广告评论传 6。", "schema": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" } }, { "name": "series_no", "in": "query", "required": true, "description": "当前集数，用于按集展示评论。", "schema": { "type": "integer", "description": "当前集数，用于按集展示评论。" } }, { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "cut_time", "in": "query", "required": false, "description": "翻页截止时间，第一页可不传，后续页传上一页返回的 cut_time。", "schema": { "type": "integer", "description": "翻页截止时间，第一页可不传，后续页传上一页返回的 cut_time。" } }, { "name": "top_comment_id", "in": "query", "required": false, "description": "需要展开或定位的评论 ID。", "schema": { "type": "integer", "description": "需要展开或定位的评论 ID。" } }, { "name": "exclude_comment_id", "in": "query", "required": false, "description": "需要排除的评论 ID。", "schema": { "type": "integer", "description": "需要排除的评论 ID。" } }, { "name": "display_scene", "in": "query", "required": false, "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。", "schema": { "type": "string", "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "id": 101, "web_comment_id": "abc123def0", "parent_comment_id": 0, "from_uid": 12345, "from_avatar": "https://cdn.example.com/avatar.png", "from_nick_name": "User", "to_avatar": "", "to_nick_name": "", "series_id": 1001, "comment_content": "Great episode", "like_num": 8, "sub_comment_num": 2, "is_like": 0, "comment_time": 1716000000, "sub_comment": [] } ], "count": 1, "page_no": 1, "page_size": 20, "has_more": 0, "actor_comment": [], "total_comment_num": 3, "cut_time": 1716000000, "watched_video_nums": 0, "open_comment": 1 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSeriesComment/sectionCountList": { "get": { "tags": [ "Web Comment" ], "summary": "Web 获取每集评论数", "description": "返回指定剧集下每一集的公开评论总数。每集总数包含该集父评论数和父评论下的回复数；待审核、隐藏、已删除评论不计入。\n\n响应契约：CommentSectionCountList。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Comment_seriesSectionCommentCountList", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "Web 端加密剧集 ID。", "schema": { "type": "string", "description": "Web 端加密剧集 ID。" } }, { "name": "video_type", "in": "query", "required": false, "description": "视频类型，普通剧集可不传。", "schema": { "type": "integer", "description": "视频类型，普通剧集可不传。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CommentSectionCountList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "series_no": 1, "total_comment_num": 3, "total_comment_num_str": "3" }, { "series_no": 2, "total_comment_num": 12, "total_comment_num_str": "12" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/CommentSectionCountList" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSeriesComment/subCommentList": { "get": { "tags": [ "Web Comment" ], "summary": "Web 获取父评论下的回复列表", "description": "返回指定父评论下的子评论列表。series_id 为 Web 端加密剧集 ID；series_no 可传当前集数以保持与父评论列表同一集维度。\n\n响应契约：ListPage。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Comment_seriesSubCommentList", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "Web 端加密剧集 ID。", "schema": { "type": "string", "description": "Web 端加密剧集 ID。" } }, { "name": "video_type", "in": "query", "required": false, "description": "视频类型，普通剧集可不传；广告评论传 6。", "schema": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" } }, { "name": "series_no", "in": "query", "required": false, "description": "当前集数。", "schema": { "type": "integer", "description": "当前集数。" } }, { "name": "parent_comment_id", "in": "query", "required": true, "description": "父评论 ID。", "schema": { "type": "integer", "description": "父评论 ID。" } }, { "name": "last_comment_id", "in": "query", "required": false, "description": "上一页最后一条子评论 ID，用于向后翻页。", "schema": { "type": "integer", "description": "上一页最后一条子评论 ID，用于向后翻页。" } }, { "name": "exclude_comment_id", "in": "query", "required": false, "description": "需要排除的评论 ID。", "schema": { "type": "integer", "description": "需要排除的评论 ID。" } }, { "name": "display_scene", "in": "query", "required": false, "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。", "schema": { "type": "string", "description": "展示场景：public=公开浏览区（默认），seo=SEO 收录区。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "list": [ { "id": 201, "web_comment_id": "reply12345", "parent_comment_id": 101, "from_uid": 12345, "from_avatar": "https://cdn.example.com/avatar.png", "from_nick_name": "User", "to_avatar": "", "to_nick_name": "", "series_id": 1001, "comment_content": "Reply content", "like_num": 1, "sub_comment_num": 0, "is_like": 0, "comment_time": 1716000100, "sub_comment": [] } ], "count": 1, "page_no": 1, "page_size": 20, "has_more": 0 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/webSeriesComment/writeComment": { "post": { "tags": [ "Web Comment" ], "summary": "Web 写入分集评论", "description": "登录用户写入当前集评论或回复评论。series_id 为 Web 端加密剧集 ID；写父评论时传 series_no，写回复时后端会继承父评论或被回复评论的 series_no。\n\n响应契约：SimpleMap。\n\n需要登录。用户无评论权限会返回 20013；文本安全检测不通过会返回参数错误。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_Comment_writeSeriesComment", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "detail": { "id": 301, "web_comment_id": "new1234567", "parent_comment_id": 0, "from_uid": 12345, "from_avatar": "https://cdn.example.com/avatar.png", "from_nick_name": "User", "to_avatar": "", "to_nick_name": "", "series_id": 1001, "comment_content": "Great episode", "like_num": 0, "sub_comment_num": 0, "is_like": 0, "comment_time": 1716000200, "sub_comment": [] } }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SimpleMap" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "series_id": { "type": "string", "description": "Web 端加密剧集 ID。" }, "video_type": { "type": "integer", "description": "视频类型，普通剧集可不传；广告评论传 6。" }, "series_no": { "type": "integer", "description": "当前集数，写父评论时必传，默认 1。" }, "parent_comment_id": { "type": "integer", "description": "父评论 ID，回复时传。" }, "sub_comment_id": { "type": "integer", "description": "被回复的子评论 ID，二级回复时传。" }, "comment_content": { "type": "string", "description": "评论内容，最多保留 500 字符。" } }, "required": [ "series_id", "comment_content" ] } } } } } }, "/webShare": { "get": { "tags": [ "Share" ], "summary": "web端获取剧集分享信息", "description": "返回 Web 端剧集分享信息。\n\n响应契约：SeriesInfo。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_Share_webGetSeriesShareInfo", "parameters": [ { "name": "series_id", "in": "query", "required": true, "description": "剧集 ID。", "schema": { "type": "integer", "description": "剧集 ID。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "series_id": 1001, "series_name": "Demo Series", "video_type": 1, "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "description": "Demo description", "watch_num": "1.2K", "collect_num": 88, "collect_num_str": "88", "lang": "en", "release_date": "2025-01-01", "tag_ids": "1,2", "series_level": 1, "video_duration": "01:30", "max_series_no": 24 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesInfo" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUnlikeSeries": { "post": { "tags": [ "WebUgcWork" ], "summary": "Web 取消点赞作品，转发到 UGC 网�", "description": "�\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_UgcWork_unlikeWork", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUnlockVideo": { "post": { "tags": [ "WebSeries" ], "summary": "Unlock Video", "description": "响应契约：EmptyObject。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "post_web_Series_unlockVideo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "section_id": { "type": "integer" } } } } } } } }, "/webUserBonusHistory": { "get": { "tags": [ "User" ], "summary": "web端bonus列表", "description": "返回 Web 端 bonus 流水列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_webUserBonusHistory", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 20。", "schema": { "type": "integer", "description": "每页条数，默认 20。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUserInfo": { "get": { "tags": [ "User" ], "summary": "web端获取用户信息", "description": "返回 Web 端用户中心需要的用户资料与站点配置。\n\n响应契约：UserProfile。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_webGetUserInfo", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "uid": 10001, "user_name": "10001", "avatar": "https://cdn.flextv.com/avatar.png", "nick": "10001", "coin": 1200, "bonus": 300, "has_pay": 1, "user_group": 1, "user_group_extended": 0, "country_code": "US", "vip_type": 0, "vip_expire_at": "", "open_comment": 1, "sign_prize": 20 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUserInfoV2": { "get": { "tags": [ "User" ], "summary": "web端获取用户信息（无加密版本）", "description": "响应契约：UserProfile。\n\n需要登录。 无需请求签名。 返回明文响应。\n\n认证要求：需要登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_User_webGetUserInfoV2", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "uid": 10001, "user_name": "10001", "avatar": "https://cdn.flextv.com/avatar.png", "nick": "10001", "coin": 1200, "bonus": 300, "has_pay": 1, "user_group": 1, "user_group_extended": 0, "country_code": "US", "vip_type": 0, "vip_expire_at": "", "open_comment": 1, "sign_prize": 20 }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/UserProfile" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUserSpendingList": { "get": { "tags": [ "User" ], "summary": "web消耗列表", "description": "返回 Web 端消费记录列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_webUserSpendingList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 20。", "schema": { "type": "integer", "description": "每页条数，默认 20。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webUserTopUpList": { "get": { "tags": [ "User" ], "summary": "web�", "description": "返回 Web 端充值记录列表。\n\n响应契约：ListPage。\n\n需要登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：需要登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_User_webUserTopUpList", "parameters": [ { "name": "page_no", "in": "query", "required": false, "description": "页码，默认 1。", "schema": { "type": "integer", "description": "页码，默认 1。" } }, { "name": "page_size", "in": "query", "required": false, "description": "每页条数，默认 20。", "schema": { "type": "integer", "description": "每页条数，默认 20。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } }, "security": [ { "TokenAuth": [] } ] } }, "/webYouMayLike": { "get": { "tags": [ "Web Recommend" ], "summary": "猜你喜欢（You May Like）", "description": "返回 Web 猜你喜欢模块短剧列表。该接口独立于 webRecommendedForYou：优先取当前语种近 7 日播放量榜，不足时用近 30 日播放量榜补齐，仍不足时用当前语种全量上架短剧兜底；PC/Web 固定最多返回 14 部，H5/WAP 固定最多返回 15 部，按播放量从高到低展示。\n\n响应契约：SeriesCardArray。\n\n无需登录。 需要请求签名。 响应会经过加密中间件。\n\n认证要求：无需登录。\n\n签名要求：需要请求签名。\n\n响应处理：默认会经过响应加密。", "operationId": "get_web_Recommend_youMayLike", "parameters": [ { "name": "series_id", "in": "query", "required": false, "description": "当前短剧 ID，传入后会从推荐结果中排除当前短剧；标签页可不传。", "schema": { "type": "integer", "description": "当前短剧 ID，传入后会从推荐结果中排除当前短剧；标签页可不传。" } }, { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } }, { "name": "timestamp", "in": "header", "required": false, "description": "请求时间戳（秒）。", "schema": { "type": "integer", "description": "请求时间戳（秒）。" } }, { "name": "signature", "in": "header", "required": false, "description": "接口签名。", "schema": { "type": "string", "description": "接口签名。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardArray" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "section_num": 24, "tag": "Romance" } ], "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/SeriesCardArray" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/weiZhenCallback": { "post": { "tags": [ "AliHls" ], "summary": "Wei Zhen Callback", "description": "响应契约：ListPage。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_AliHls_weiZhenCallback", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": { "paging": { "page_no": 1, "page_size": 20, "total": 1 }, "list": [ { "series_id": 1001, "video_type": 1, "series_name": "Demo Series", "description": "Demo description", "cover": "https://cdn.flextv.com/series.jpg", "serial_status": 1, "watch_num": "1.2K", "watch_num_int": 1200, "collect_num": 88, "collect_num_str": "88", "last_series_no": 24, "section_num": 24, "tag": "Romance" } ] }, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/ListPage" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } }, "/whatsappNotify/webhook": { "get": { "tags": [ "DirectToCustomer" ], "summary": "Whatsapp Notify", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "get_DirectToCustomer_whatsappNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } }, "post": { "tags": [ "DirectToCustomer" ], "summary": "Whatsapp Notify", "description": "响应契约：EmptyObject。\n\n无需登录。 无需请求签名。 返回明文响应。\n\n认证要求：无需登录。\n\n签名要求：无需请求签名。\n\n响应处理：返回明文响应。", "operationId": "post_DirectToCustomer_whatsappNotify", "parameters": [ { "name": "lang", "in": "header", "required": false, "description": "语言代码，例如 en、zh、es。", "schema": { "type": "string", "description": "语言代码，例如 en、zh、es。" } }, { "name": "device_number", "in": "header", "required": false, "description": "设备唯一标识。", "schema": { "type": "string", "description": "设备唯一标识。" } }, { "name": "app_version", "in": "header", "required": false, "description": "客户端版本号。", "schema": { "type": "string", "description": "客户端版本号。" } } ], "responses": { "200": { "description": "请求成功", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 0, "msg": "成功", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } }, "400": { "description": "请求失败", "content": { "application/json": { "schema": { "type": "object", "required": [ "code", "msg", "data", "info", "is_encrypt", "request_id", "response_time" ], "properties": { "code": { "type": "integer", "example": 0 }, "msg": { "type": "string", "example": "成功" }, "data": { "$ref": "#/components/schemas/EmptyObject" }, "info": { "type": "object", "additionalProperties": true }, "is_encrypt": { "type": "integer", "enum": [ 0, 1 ] }, "request_id": { "type": "string" }, "response_time": { "type": "integer" }, "original_data": { "type": "object", "additionalProperties": true } } }, "example": { "code": 10001, "msg": "参数错误", "data": {}, "info": {}, "is_encrypt": 0, "request_id": "request_demo_123", "response_time": 1710000000 } } } } } } } }, "components": { "securitySchemes": { "TokenAuth": { "type": "apiKey", "in": "header", "name": "token", "description": "登录态令牌。仅在需要登录的接口上生效。" } }, "schemas": { "EmptyObject": { "type": "object", "description": "空对象。", "properties": {}, "additionalProperties": false }, "SimpleFlag": { "type": "object", "description": "简单状态返回。", "properties": { "sent": { "type": "boolean", "example": true } }, "required": [ "sent" ] }, "SimpleValue": { "type": "object", "description": "单值对象。", "properties": { "token": { "type": "string", "example": "token_demo_123" } }, "required": [ "token" ] }, "Paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "AuthResult": { "type": "object", "description": "登录、注册和刷新 token 的返回结果。", "properties": { "token": { "type": "string", "description": "登录 token。" }, "uid": { "type": "integer", "description": "用户 ID。" }, "account_type": { "type": "integer", "description": "账号类型。" }, "country_code": { "type": "string", "description": "国家码。" }, "openid": { "type": "string", "description": "三方账号 openid。" }, "name": { "type": "string", "description": "昵称或姓名。" }, "avatar": { "type": "string", "description": "头像。" }, "gender": { "type": "integer", "description": "性别。" }, "email": { "type": "string", "description": "邮箱。" }, "first_name": { "type": "string", "description": "名。" }, "last_name": { "type": "string", "description": "姓。" }, "refresh_token": { "type": "string", "description": "刷新 token。" }, "url": { "type": "string", "description": "登录跳转地址。" }, "code": { "type": "string", "description": "设备登录码。" }, "expire_at": { "type": "integer", "description": "过期时间戳。" }, "lang": { "type": "string", "description": "语言代码。" }, "password": { "type": "string", "description": "注册或重置后的明文密码。" } } }, "UserProfile": { "type": "object", "description": "用户中心聚合资料。", "properties": { "uid": { "type": "integer" }, "user_name": { "type": "string" }, "avatar": { "type": "string" }, "nick": { "type": "string" }, "last_login_time": { "type": "string" }, "user_type": { "type": "integer" }, "last_pay_time": { "type": "integer" }, "device_number": { "type": "string" }, "user_group": { "type": "integer" }, "user_group_extended": { "type": "integer" }, "create_at": { "type": "integer" }, "status": { "type": "integer" }, "country_code": { "type": "string" }, "coin": { "type": "integer" }, "bonus": { "type": "integer" }, "account_type": { "type": "integer" }, "has_pay": { "type": "integer" }, "bonus_task": { "type": "integer" }, "user_identity": { "type": "integer" }, "vip_type": { "type": "integer" }, "vip_recharge_status": { "type": "integer" }, "vip_recharge_message": { "type": "string" }, "open_unlock_popup": { "type": "integer" }, "open_recharge_popup": { "type": "integer" }, "vip_expire_at": { "type": "string" }, "has_bind_account": { "type": "integer" }, "invite_tab": { "type": "integer" }, "open_comment": { "type": "integer" }, "sign_prize": { "type": "integer" }, "web_section_num_third_party_login": { "type": "integer" }, "web_section_num_jump_to_app": { "type": "integer" }, "ugc_switch_open": { "type": "integer" } } }, "SignDay": { "type": "object", "properties": { "day": { "type": "integer" }, "is_sign": { "type": "integer" }, "prize": { "type": "integer" } } }, "SignList": { "type": "object", "description": "签到信息和奖励列表。", "properties": { "today_is_sign": { "type": "integer" }, "list": { "type": "array", "items": { "type": "object", "properties": { "day": { "type": "integer" }, "is_sign": { "type": "integer" }, "prize": { "type": "integer" } } } } } }, "SignResult": { "type": "object", "description": "签到成功后的奖励信息。", "properties": { "prize_coin": { "type": "integer" }, "bonus_expired_at": { "type": "integer" }, "sign_log": { "type": "object", "properties": { "uid": { "type": "integer" }, "days": { "type": "integer" }, "prize_coin": { "type": "integer" }, "country": { "type": "string" }, "created_at": { "type": "integer" } } } } }, "LikeResult": { "type": "object", "description": "点赞后的计数展示值。", "properties": { "like_num_str": { "type": "string" } } }, "CollectResult": { "oneOf": [ { "type": "object", "description": "旧版本返回的单个计数对象。", "properties": { "collect_num_str": { "type": "string" } } }, { "type": "array", "description": "新版本返回的计数列表。", "items": { "type": "object", "properties": { "series_id": { "type": "integer" }, "collect_num_str": { "type": "string" } } } } ] }, "UnlockResult": { "type": "object", "description": "解锁分集后的扣减结果。", "properties": { "coin": { "type": "integer", "description": "实际扣减金币。" }, "bonus": { "type": "integer", "description": "实际扣减 bonus。" } }, "required": [ "coin", "bonus" ] }, "BannerItem": { "type": "object", "properties": { "title": { "type": "string" }, "image": { "type": "string" }, "jump_type": { "type": "integer" }, "link": { "type": "string" }, "series_id": { "type": "integer" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } }, "BannerList": { "type": "object", "description": "Banner 列表。", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "image": { "type": "string" }, "jump_type": { "type": "integer" }, "link": { "type": "string" }, "series_id": { "type": "integer" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } } } } }, "HomeBannerList": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "image": { "type": "string" }, "jump_type": { "type": "integer" }, "link": { "type": "string" }, "series_id": { "type": "integer" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } } }, "FloorItem": { "type": "object", "properties": { "floor_id": { "type": "integer" }, "title": { "type": "string" }, "url_title": { "type": "string" }, "template_type": { "type": "integer" }, "has_more": { "type": "integer" }, "list": { "type": "array", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } } } }, "HomeFloorSummaryList": { "type": "array", "items": { "type": "object", "properties": { "floor_id": { "type": "integer" }, "title": { "type": "string" }, "url_title": { "type": "string" }, "template_type": { "type": "integer" }, "has_more": { "type": "integer" }, "list": { "type": "array", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } } } } }, "IndexFloorList": { "type": "object", "description": "首页楼层聚合数据。", "properties": { "nav": { "type": "array", "items": { "type": "object", "properties": { "nav_id": { "type": "integer" }, "nav_name": { "type": "string" } } } }, "banner": { "type": "array", "items": { "type": "object", "properties": { "title": { "type": "string" }, "image": { "type": "string" }, "jump_type": { "type": "integer" }, "link": { "type": "string" }, "series_id": { "type": "integer" }, "description": { "type": "string" }, "tags": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } } }, "floor": { "type": "array", "items": { "type": "object", "properties": { "floor_id": { "type": "integer" }, "title": { "type": "string" }, "url_title": { "type": "string" }, "template_type": { "type": "integer" }, "has_more": { "type": "integer" }, "list": { "type": "array", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } } } } }, "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "list": { "type": "array", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } } } }, "TagItem": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] }, "TagList": { "type": "object", "description": "标签列表。", "properties": { "list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } }, "HotTagItem": { "type": "object", "description": "热门标签项。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" }, "rank_no": { "type": "integer", "description": "当前语言下热门标签排名，从 1 开始。" }, "click_uv": { "type": "integer", "description": "近 30 天标签点击 UV；兜底标签没有统计数据时为 0。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] }, "HotTagList": { "type": "array", "description": "Web 热门标签列表，按近 30 天标签点击 UV 排序。", "items": { "type": "object", "description": "热门标签项。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" }, "rank_no": { "type": "integer", "description": "当前语言下热门标签排名，从 1 开始。" }, "click_uv": { "type": "integer", "description": "近 30 天标签点击 UV；兜底标签没有统计数据时为 0。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "TagPageList": { "type": "object", "description": "Web 全部标签聚合页分页数据。系统内容标签整体在前，Web 自定义标签整体在后。", "properties": { "paging": { "type": "object", "description": "分页信息，total 为当前语言下满足展示条件的系统标签与 Web 自定义标签总数。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "list": { "type": "array", "description": "当前页标签列表；前端按接口返回顺序直接展示。", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } }, "required": [ "paging", "list" ] }, "TagDetail": { "type": "object", "description": "Web 标签详情页数据。", "properties": { "tag_info": { "type": "object", "description": "标签头部及 TDK 信息。标签不存在、语言不匹配或 Web 自定义标签已下架/删除时返回空对象。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id。" }, "tag_name": { "type": "string", "description": "当前语言下的完整标签名称。" }, "url_title": { "type": "string", "description": "当前标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "当前标签对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" }, "is_custom_tag": { "type": "integer", "description": "是否为 Web 自定义标签：1 是，0 否（系统内容标签）。", "enum": [ 0, 1 ] }, "title": { "type": "string", "description": "页面 SEO Title。Web 自定义标签优先返回后台 TDK 配置中的 seo_title；未配置时返回标签名称。" }, "description": { "type": "string", "description": "页面 SEO Description。Web 自定义标签优先返回后台 TDK 配置中的 seo_description；未配置时返回系统生成的默认描述。" }, "keywords": { "type": "string", "description": "页面 SEO Keywords。Web 自定义标签优先返回后台 TDK 配置中的 seo_keywords；未配置时返回标签名称。" }, "series_total": { "type": "integer", "description": "符合语言、上架、审核通过、未隐藏条件的关联短剧总数。国家版权过滤在分页查询后执行，因此 list 实际数量可能少于 page_size。" } } }, "related_tags": { "type": "array", "description": "关联标签列表，仅包含同语言、已上架的 Web 自定义标签，按创建时间倒序，默认最多 10 条。后台配置的关联标签均可返回；完整名称中当前标签作为独立词出现时，仅删除该独立词作为展示名称，否则原样展示。", "items": { "type": "object", "description": "标签详情页关联标签。跳转目标是完整关联标签，但 tag_name 仅为移除当前标签词后的特征词。", "properties": { "tag_id": { "type": "integer", "description": "完整关联标签的内部数字 ID。" }, "tag_name": { "type": "string", "description": "关联标签展示文本，已移除当前标签词。例如当前标签为 work、完整关联标签为 good work 时返回 good。" }, "url_title": { "type": "string", "description": "完整关联标签的 URL 基础 slug，例如 good-work。" }, "web_tag_id": { "type": "string", "description": "完整关联标签的对外 hash ID；与 url_title 拼接后跳转到完整关联标签详情页。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "paging": { "type": "object", "description": "短剧列表分页信息，total 与 tag_info.series_total 一致。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "list": { "type": "array", "description": "当前页短剧列表。Web 自定义标签按后台绑定权重倒序；系统内容标签按短剧上架时间倒序。", "items": { "type": "object", "description": "标签详情页短剧列表项。", "properties": { "series_id": { "type": "integer", "description": "短剧 ID。" }, "series_name": { "type": "string", "description": "当前请求语言下的短剧名称；存在多语言配置时优先返回多语言名称。" }, "description": { "type": "string", "description": "当前请求语言下的短剧简介；存在多语言配置时优先返回多语言简介。" }, "cover": { "type": "string", "description": "适用于 Web 卡片展示的完整封面图片 URL。" }, "serial_status": { "type": "integer", "description": "连载状态：0 连载中，1 已完结。", "enum": [ 0, 1 ] }, "video_type": { "type": "integer", "description": "内容类型：1 短剧，2 电视剧，3 电影，4 动漫，5 UGC 视频，6 广告，7 AI 剧。", "enum": [ 1, 2, 3, 4, 5, 6, 7 ] }, "section_num": { "type": "integer", "description": "当前短剧集数或最新更新集数。" }, "section_id": { "type": "integer", "description": "首集分集 ID；不存在首集时为 0。" }, "show_video_type": { "type": "integer", "description": "视频类型展示控制字段；当前接口固定返回 0，为前端兼容保留。" }, "icon_type": { "type": "integer", "description": "卡片角标类型，0 表示不展示角标；其他值按客户端既有角标规则处理。" }, "icon_text": { "type": "string", "description": "卡片角标文案，无角标时为空字符串。" }, "collect_num": { "type": "integer", "description": "用于页面展示的收藏数量整数值。" }, "collect_num_str": { "type": "string", "description": "格式化后的收藏数量，例如 1.2K、3.4M。" }, "watch_num_int": { "type": "integer", "description": "用于页面展示的观看数量整数值。" }, "watch_num_str": { "type": "string", "description": "格式化后的观看数量，例如 56K、2.3M。" }, "tag": { "type": "array", "description": "短剧自身的系统内容标签，不包含通过 web_custom_tag_series 绑定的 Web 自定义标签。", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } }, "required": [ "series_id", "series_name", "description", "cover", "serial_status", "video_type", "section_num", "section_id", "show_video_type", "icon_type", "icon_text", "collect_num", "collect_num_str", "watch_num_int", "watch_num_str", "tag" ] } } }, "required": [ "tag_info", "related_tags", "paging", "list" ] }, "TagDetailSeriesItem": { "type": "object", "description": "标签详情页短剧列表项。", "properties": { "series_id": { "type": "integer", "description": "短剧 ID。" }, "series_name": { "type": "string", "description": "当前请求语言下的短剧名称；存在多语言配置时优先返回多语言名称。" }, "description": { "type": "string", "description": "当前请求语言下的短剧简介；存在多语言配置时优先返回多语言简介。" }, "cover": { "type": "string", "description": "适用于 Web 卡片展示的完整封面图片 URL。" }, "serial_status": { "type": "integer", "description": "连载状态：0 连载中，1 已完结。", "enum": [ 0, 1 ] }, "video_type": { "type": "integer", "description": "内容类型：1 短剧，2 电视剧，3 电影，4 动漫，5 UGC 视频，6 广告，7 AI 剧。", "enum": [ 1, 2, 3, 4, 5, 6, 7 ] }, "section_num": { "type": "integer", "description": "当前短剧集数或最新更新集数。" }, "section_id": { "type": "integer", "description": "首集分集 ID；不存在首集时为 0。" }, "show_video_type": { "type": "integer", "description": "视频类型展示控制字段；当前接口固定返回 0，为前端兼容保留。" }, "icon_type": { "type": "integer", "description": "卡片角标类型，0 表示不展示角标；其他值按客户端既有角标规则处理。" }, "icon_text": { "type": "string", "description": "卡片角标文案，无角标时为空字符串。" }, "collect_num": { "type": "integer", "description": "用于页面展示的收藏数量整数值。" }, "collect_num_str": { "type": "string", "description": "格式化后的收藏数量，例如 1.2K、3.4M。" }, "watch_num_int": { "type": "integer", "description": "用于页面展示的观看数量整数值。" }, "watch_num_str": { "type": "string", "description": "格式化后的观看数量，例如 56K、2.3M。" }, "tag": { "type": "array", "description": "短剧自身的系统内容标签，不包含通过 web_custom_tag_series 绑定的 Web 自定义标签。", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } }, "required": [ "series_id", "series_name", "description", "cover", "serial_status", "video_type", "section_num", "section_id", "show_video_type", "icon_type", "icon_text", "collect_num", "collect_num_str", "watch_num_int", "watch_num_str", "tag" ] }, "TagCategoryGroup": { "type": "object", "properties": { "group_type": { "type": "integer" }, "group_name": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } }, "TagCategoryList": { "type": "object", "description": "Web 标签页主标签/次标签分组列表。", "properties": { "primary": { "type": "array", "items": { "type": "object", "properties": { "group_type": { "type": "integer" }, "group_name": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } } }, "secondary": { "type": "array", "items": { "type": "object", "properties": { "group_type": { "type": "integer" }, "group_name": { "type": "string" }, "list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } } } } }, "SeriesCard": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } }, "SeriesCardArray": { "type": "array", "description": "剧集卡片数组。", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } }, "SeriesCardList": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "description": "剧集卡片。", "properties": { "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "tv_cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "section_num": { "type": "integer" }, "tag_ids": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" } } } } } }, "SeriesSectionItem": { "type": "object", "properties": { "id": { "type": "integer" }, "series_id": { "type": "integer" }, "series_no": { "type": "integer" }, "video_id": { "type": "integer" }, "is_charge": { "type": "integer" }, "unit_price": { "type": "integer" }, "like_num": { "type": "integer" }, "like_num_str": { "type": "string" }, "watch_num": { "type": "string" }, "has_pay": { "type": "integer" }, "is_like": { "type": "integer" }, "cover": { "type": "string" }, "summary": { "type": "string", "description": "分集简介；第一集、付费集使用剧简介，其它分集为空时回落到剧简介。" }, "level_price": { "type": "string" }, "video_duration": { "type": "integer" }, "publish_time": { "type": "integer" }, "lang": { "type": "string" } } }, "SeriesSectionRange": { "type": "object", "properties": { "range_id": { "type": "integer" }, "start_series_no": { "type": "integer" }, "end_series_no": { "type": "integer" } } }, "SeriesDetail": { "type": "object", "description": "剧集基础详情。", "properties": { "series_id": { "type": "integer" }, "series_id_origin": { "type": "integer" }, "series_name": { "type": "string" }, "video_type": { "type": "integer" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "series_status": { "type": "integer" }, "description": { "type": "string" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "like_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" }, "current_range_id": { "type": "integer" }, "recently_series_no": { "type": "integer" }, "video_duration": { "type": "string" }, "langs": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag_ids": { "type": "string" }, "series_level": { "type": "integer" }, "trial_time": { "type": "integer" }, "release_protection": { "type": "integer" }, "lang": { "type": "string" }, "director": { "type": "string" }, "writer": { "type": "string" }, "starring": { "type": "string" }, "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "unit_price": { "type": "integer" }, "progress": { "type": "string" } } }, "SeriesInfo": { "type": "object", "description": "剧集基础详情。", "properties": { "series_id": { "type": "integer" }, "series_id_origin": { "type": "integer" }, "series_name": { "type": "string" }, "video_type": { "type": "integer" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "series_status": { "type": "integer" }, "description": { "type": "string" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "like_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" }, "current_range_id": { "type": "integer" }, "recently_series_no": { "type": "integer" }, "video_duration": { "type": "string" }, "langs": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag_ids": { "type": "string" }, "series_level": { "type": "integer" }, "trial_time": { "type": "integer" }, "release_protection": { "type": "integer" }, "lang": { "type": "string" }, "director": { "type": "string" }, "writer": { "type": "string" }, "starring": { "type": "string" }, "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "unit_price": { "type": "integer" }, "progress": { "type": "string" } } }, "SeriesSectionBundle": { "type": "object", "description": "剧集选集聚合数据。", "properties": { "detail": { "type": "object", "description": "剧集基础详情。", "properties": { "series_id": { "type": "integer" }, "series_id_origin": { "type": "integer" }, "series_name": { "type": "string" }, "video_type": { "type": "integer" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "series_status": { "type": "integer" }, "description": { "type": "string" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "like_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" }, "current_range_id": { "type": "integer" }, "recently_series_no": { "type": "integer" }, "video_duration": { "type": "string" }, "langs": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag_ids": { "type": "string" }, "series_level": { "type": "integer" }, "trial_time": { "type": "integer" }, "release_protection": { "type": "integer" }, "lang": { "type": "string" }, "director": { "type": "string" }, "writer": { "type": "string" }, "starring": { "type": "string" }, "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "unit_price": { "type": "integer" }, "progress": { "type": "string" } } }, "tag": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "range_size": { "type": "integer" }, "range_list": { "type": "array", "items": { "type": "object", "properties": { "range_id": { "type": "integer" }, "start_series_no": { "type": "integer" }, "end_series_no": { "type": "integer" } } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "series_id": { "type": "integer" }, "series_no": { "type": "integer" }, "video_id": { "type": "integer" }, "is_charge": { "type": "integer" }, "unit_price": { "type": "integer" }, "like_num": { "type": "integer" }, "like_num_str": { "type": "string" }, "watch_num": { "type": "string" }, "has_pay": { "type": "integer" }, "is_like": { "type": "integer" }, "cover": { "type": "string" }, "summary": { "type": "string", "description": "分集简介；第一集、付费集使用剧简介，其它分集为空时回落到剧简介。" }, "level_price": { "type": "string" }, "video_duration": { "type": "integer" }, "publish_time": { "type": "integer" }, "lang": { "type": "string" } } } }, "play_info": { "type": "object", "properties": { "video_url": { "type": "string" }, "progressive": { "type": "array", "items": { "type": "object", "properties": {} } }, "subtitle": { "type": "array", "items": { "type": "object", "properties": {} } }, "is_trial": { "type": "integer" }, "duration": { "type": "integer" }, "upload_date": { "type": "integer" } } } } }, "SeriesDetailContent": { "type": "object", "properties": { "detail": { "type": "object", "description": "剧集基础详情。", "properties": { "series_id": { "type": "integer" }, "series_id_origin": { "type": "integer" }, "series_name": { "type": "string" }, "video_type": { "type": "integer" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "series_status": { "type": "integer" }, "description": { "type": "string" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "like_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" }, "current_range_id": { "type": "integer" }, "recently_series_no": { "type": "integer" }, "video_duration": { "type": "string" }, "langs": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag_ids": { "type": "string" }, "series_level": { "type": "integer" }, "trial_time": { "type": "integer" }, "release_protection": { "type": "integer" }, "lang": { "type": "string" }, "director": { "type": "string" }, "writer": { "type": "string" }, "starring": { "type": "string" }, "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "unit_price": { "type": "integer" }, "progress": { "type": "string" } } }, "tag": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } } } }, "SeriesSectionContentList": { "type": "object", "properties": { "detail": { "type": "object", "description": "剧集基础详情。", "properties": { "series_id": { "type": "integer" }, "series_id_origin": { "type": "integer" }, "series_name": { "type": "string" }, "video_type": { "type": "integer" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "series_status": { "type": "integer" }, "description": { "type": "string" }, "watch_num": { "type": "string" }, "watch_num_int": { "type": "integer" }, "collect_num": { "type": "integer" }, "collect_num_str": { "type": "string" }, "like_num_str": { "type": "string" }, "last_series_no": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" }, "current_range_id": { "type": "integer" }, "recently_series_no": { "type": "integer" }, "video_duration": { "type": "string" }, "langs": { "type": "array", "items": { "type": "object", "description": "可跳转的标签基础信息。", "properties": { "tag_id": { "type": "integer", "description": "标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。" }, "tag_name": { "type": "string", "description": "当前语言下的标签展示名称。" }, "url_title": { "type": "string", "description": "标签 URL 基础 slug，不包含 web_tag_id。" }, "web_tag_id": { "type": "string", "description": "由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。" } }, "required": [ "tag_id", "tag_name", "url_title", "web_tag_id" ] } }, "tag_ids": { "type": "string" }, "series_level": { "type": "integer" }, "trial_time": { "type": "integer" }, "release_protection": { "type": "integer" }, "lang": { "type": "string" }, "director": { "type": "string" }, "writer": { "type": "string" }, "starring": { "type": "string" }, "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "unit_price": { "type": "integer" }, "progress": { "type": "string" } } }, "range_size": { "type": "integer" }, "range_list": { "type": "array", "items": { "type": "object", "properties": { "range_id": { "type": "integer" }, "start_series_no": { "type": "integer" }, "end_series_no": { "type": "integer" } } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "series_id": { "type": "integer" }, "series_no": { "type": "integer" }, "video_id": { "type": "integer" }, "is_charge": { "type": "integer" }, "unit_price": { "type": "integer" }, "like_num": { "type": "integer" }, "like_num_str": { "type": "string" }, "watch_num": { "type": "string" }, "has_pay": { "type": "integer" }, "is_like": { "type": "integer" }, "cover": { "type": "string" }, "summary": { "type": "string", "description": "分集简介；第一集、付费集使用剧简介，其它分集为空时回落到剧简介。" }, "level_price": { "type": "string" }, "video_duration": { "type": "integer" }, "publish_time": { "type": "integer" }, "lang": { "type": "string" } } } } } }, "SeriesUserState": { "type": "object", "properties": { "detail": { "type": "object", "properties": { "is_like": { "type": "integer" }, "is_collect": { "type": "integer" }, "has_unlock_history": { "type": "integer" }, "max_can_play_series_no": { "type": "integer" }, "current_series_no": { "type": "integer" } } } } }, "SeriesSectionStateList": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "series_id": { "type": "integer" }, "series_no": { "type": "integer" }, "is_like": { "type": "integer" }, "has_pay": { "type": "integer" } } } } } }, "StatusMap": { "type": "object", "description": "字符串键到状态值的映射。", "additionalProperties": { "type": "integer" } }, "ShareInfo": { "type": "object", "properties": { "share_url": { "type": "string" }, "share_content": { "type": "array", "items": { "type": "string" } } } }, "PaymentProduct": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } }, "PaymentMethod": { "type": "object", "properties": { "payment": { "type": "integer", "description": "支付方式 ID。" }, "payment_name": { "type": "string", "description": "支付方式名称。" }, "platform": { "type": "integer", "description": "支付平台。" }, "payment_icon": { "type": "string", "description": "支付方式图标。" } } }, "PaymentPanelV4": { "type": "object", "properties": { "top_list": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } } }, "list": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } } }, "popup_info": { "type": "array", "items": { "type": "object", "properties": {} } }, "count_down": { "type": "integer" } } }, "PaymentPanelV5": { "type": "object", "properties": { "retain_way": { "type": "integer" }, "bannerLevelList": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } } }, "normalLevelList": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } } }, "vipList": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "corner_mark_text": { "type": "string" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "subtitle": { "type": "string" }, "offer_id": { "type": "string", "description": "优惠ID（Stripe Coupon ID）。" } } } } } }, "PaymentPanelWeb": { "type": "object", "properties": { "payment_list": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "integer", "description": "支付方式 ID。" }, "payment_name": { "type": "string", "description": "支付方式名称。" }, "platform": { "type": "integer", "description": "支付平台。" }, "payment_icon": { "type": "string", "description": "支付方式图标。" } } } }, "recharge_list": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "is_discount": { "type": "integer", "description": "定价类型：0=固定付费，1=阶梯付费。" }, "pricing_type_text": { "type": "string", "description": "定价类型文案：fixed/tiered。" }, "discount_price": { "type": "string", "description": "首订价格($)。固定付费时与续订价格一致。" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "recharge_originate": { "type": "integer", "description": "充值来源标识。" }, "free_ratio": { "type": "string" }, "corner_mark_text": { "type": "string" }, "corner_mark_type": { "type": "integer" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "is_vip": { "type": "integer" }, "subtitle": { "type": "string" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "card_style": { "type": "integer" } } } }, "vip_list": { "type": "array", "items": { "type": "object", "properties": { "recharge_id": { "type": "string" }, "store_product_id": { "type": "string" }, "base_plan_id": { "type": "string" }, "product_type": { "type": "integer" }, "package_type": { "type": "integer" }, "product_price": { "type": "string" }, "coin": { "type": "integer" }, "free_coin": { "type": "integer" }, "third_party": { "type": "array", "items": { "type": "object", "properties": { "payment": { "type": "string" }, "free_coin": { "type": "integer" }, "free_ratio": { "type": "string" } } } }, "corner_mark_text": { "type": "string" }, "page_corner_mark_text": { "type": "string" }, "page_corner_mark_type": { "type": "integer" }, "original_price_coefficient": { "type": "string" }, "is_selected": { "type": "integer" }, "subtitle": { "type": "string" }, "offer_id": { "type": "string", "description": "优惠ID（Stripe Coupon ID）。" } } } }, "default_payment": { "type": "integer" } } }, "OrderResult": { "type": "object", "properties": { "order_id": { "type": "string" }, "payment_url": { "type": "string", "description": "三方支付跳转地址；非三方支付可能为空字符串。" } } }, "TransactionStatus": { "type": "object", "properties": { "status": { "type": "integer" }, "order_id": { "type": "string" }, "trade_id": { "type": "string" } } }, "SignatureResult": { "type": "object", "properties": { "signature": { "type": "string" }, "nonce": { "type": "string" }, "timestamp": { "type": "integer" }, "keyIdentifier": { "type": "string" } } }, "TrailerItem": { "type": "object", "properties": { "preview_id": { "type": "integer" }, "series_id": { "type": "integer" }, "title": { "type": "string" }, "cover": { "type": "string" }, "page_no": { "type": "integer" } } }, "TrailerList": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "preview_id": { "type": "integer" }, "series_id": { "type": "integer" }, "title": { "type": "string" }, "cover": { "type": "string" }, "page_no": { "type": "integer" } } } }, "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] } } }, "TrailerDetail": { "type": "object", "properties": { "preview_id": { "type": "integer" }, "series_id": { "type": "integer" }, "title": { "type": "string" }, "cover": { "type": "string" } } }, "KeywordList": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "string" } } } }, "RankingItem": { "type": "object", "properties": { "rank_tab_id": { "type": "integer" }, "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "string" } }, "tag": { "type": "string" } } }, "RankingTab": { "type": "object", "properties": { "rank_tab_id": { "type": "integer" }, "rank_tab_name": { "type": "string" }, "lang": { "type": "string" } } }, "RankingList": { "type": "object", "properties": { "ranking_tab": { "type": "array", "items": { "type": "object", "properties": { "rank_tab_id": { "type": "integer" }, "rank_tab_name": { "type": "string" }, "lang": { "type": "string" } } } }, "ranking_list": { "type": "array", "items": { "type": "object", "properties": { "rank_tab_id": { "type": "integer" }, "series_id": { "type": "integer" }, "video_type": { "type": "integer" }, "series_name": { "type": "string" }, "description": { "type": "string" }, "cover": { "type": "string" }, "serial_status": { "type": "integer" }, "watch_num": { "type": "string" }, "series_topic": { "type": "string" }, "show_video_type": { "type": "integer" }, "icon_type": { "type": "integer" }, "icon_text": { "type": "string" }, "icon_color": { "type": "string" }, "icon": { "type": "string" }, "tag_list": { "type": "array", "items": { "type": "string" } }, "tag": { "type": "string" } } } }, "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] } } }, "CollectHistoryItem": { "type": "object", "properties": { "series_id": { "type": "integer" }, "series_name": { "type": "string" }, "cover": { "type": "string" }, "watch_num": { "type": "string" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" } } }, "CollectHistoryList": { "type": "object", "properties": { "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "list": { "type": "array", "items": { "type": "object", "properties": { "series_id": { "type": "integer" }, "series_name": { "type": "string" }, "cover": { "type": "string" }, "watch_num": { "type": "string" }, "collect_num_str": { "type": "string" }, "last_series_no": { "type": "integer" } } } } } }, "ActionResult": { "type": "object", "properties": { "result": { "type": "boolean" } } }, "SimpleMap": { "type": "object", "properties": { "data": { "type": "boolean" } } }, "AppConfig": { "type": "object", "additionalProperties": true, "properties": { "positive_vote_star": { "type": "integer" }, "min_play_time": { "type": "integer" }, "invite_tab_url": { "type": "string" }, "extend_check_time": { "type": "integer" }, "show_game_list_tab": { "type": "integer", "enum": [ 0, 1 ] }, "lang": { "type": "array", "items": { "type": "object", "properties": { "lang_code": { "type": "string" }, "lang": { "type": "string" } } } } } }, "GameItem": { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" } } }, "GameRecentItem": { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" }, "last_play_at": { "type": "integer" }, "play_count": { "type": "integer" } } }, "GameRecommendItem": { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" }, "sort": { "type": "integer" } } }, "GameMyList": { "type": "object", "properties": { "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "recently_play": { "type": "array", "items": { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" }, "last_play_at": { "type": "integer" }, "play_count": { "type": "integer" } } } }, "you_may_like": { "type": "array", "items": { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" }, "sort": { "type": "integer" } } } } } }, "GameTabStatus": { "type": "object", "properties": { "show_game_list_tab": { "type": "integer", "enum": [ 0, 1 ] }, "has_recently_play": { "type": "integer", "enum": [ 0, 1 ] }, "has_you_may_like": { "type": "integer", "enum": [ 0, 1 ] } } }, "GameRecentPlayResult": { "type": "object", "properties": { "matched": { "type": "integer", "enum": [ 0, 1 ] }, "game": { "oneOf": [ { "type": "object", "properties": { "game_id": { "type": "integer" }, "frontend_name": { "type": "string" }, "intro": { "type": "string" }, "icon_url": { "type": "string" }, "game_url": { "type": "string" }, "score": { "type": "number", "format": "float" } } }, { "type": "array", "description": "未匹配到游戏时返回空数组。", "items": { "type": "object" }, "maxItems": 0 } ] } } }, "FirstPagePopupItem": { "type": "object", "description": "首页弹窗推荐项。", "properties": { "id": { "type": "integer", "description": "推荐配置 ID。" }, "recommend_name": { "type": "string", "description": "推荐标题。" }, "image": { "type": "string", "description": "弹窗图片地址。当弹窗样式为整图(5)时，客户端应直接以整图方式展示此图。" }, "jump_type": { "type": "string", "description": "跳转类型：play=跳转剧集；open_url=外链；inner_url=内嵌跳转；rand_series=随机剧集（服务端会改写为 play）。", "enum": [ "play", "open_url", "inner_url", "rand_series" ] }, "jump_value": { "type": "string", "description": "跳转目标值（剧集 ID 或 URL 等）。" }, "pop_up_style": { "type": "integer", "description": "弹窗样式枚举：\n 0 = 通用\n 1 = 爱情\n 2 = 古装\n 3 = 萌宝\n 4 = 逆袭\n 5 = 整图（整图模式下直接展示运营上传的图片，不再叠加样式模板）", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "url": { "type": "string", "description": "外链 URL，仅当 jump_type=open_url/inner_url 时有效。" }, "series_id": { "type": "integer", "description": "关联剧集 ID（0 表示无）。" }, "is_collect": { "type": "integer", "description": "是否已收藏：0/1。", "enum": [ 0, 1 ] }, "tags": { "type": "array", "description": "额外标签列表，预留字段。", "items": { "type": "object", "additionalProperties": true } }, "end_time": { "type": "integer", "description": "活动结束时间（毫秒）。" }, "every_hour": { "type": "integer", "description": "弹出频率：每 N 小时。由 extra.every_hour 带出。" }, "pop_time": { "type": "integer", "description": "弹出次数上限。由 extra.pop_time 带出。" }, "home_status": { "type": "integer", "description": "首页场景是否生效：0/1。", "enum": [ 0, 1 ] }, "foryou_status": { "type": "integer", "description": "foryou 场景是否生效：0/1。", "enum": [ 0, 1 ] }, "play_status": { "type": "integer", "description": "播放器场景是否生效：0/1。", "enum": [ 0, 1 ] } } }, "FirstPagePopupList": { "type": "array", "description": "首页弹窗推荐列表。响应 data 即为数组，未再包 list 层。", "items": { "type": "object", "description": "首页弹窗推荐项。", "properties": { "id": { "type": "integer", "description": "推荐配置 ID。" }, "recommend_name": { "type": "string", "description": "推荐标题。" }, "image": { "type": "string", "description": "弹窗图片地址。当弹窗样式为整图(5)时，客户端应直接以整图方式展示此图。" }, "jump_type": { "type": "string", "description": "跳转类型：play=跳转剧集；open_url=外链；inner_url=内嵌跳转；rand_series=随机剧集（服务端会改写为 play）。", "enum": [ "play", "open_url", "inner_url", "rand_series" ] }, "jump_value": { "type": "string", "description": "跳转目标值（剧集 ID 或 URL 等）。" }, "pop_up_style": { "type": "integer", "description": "弹窗样式枚举：\n 0 = 通用\n 1 = 爱情\n 2 = 古装\n 3 = 萌宝\n 4 = 逆袭\n 5 = 整图（整图模式下直接展示运营上传的图片，不再叠加样式模板）", "enum": [ 0, 1, 2, 3, 4, 5 ] }, "url": { "type": "string", "description": "外链 URL，仅当 jump_type=open_url/inner_url 时有效。" }, "series_id": { "type": "integer", "description": "关联剧集 ID（0 表示无）。" }, "is_collect": { "type": "integer", "description": "是否已收藏：0/1。", "enum": [ 0, 1 ] }, "tags": { "type": "array", "description": "额外标签列表，预留字段。", "items": { "type": "object", "additionalProperties": true } }, "end_time": { "type": "integer", "description": "活动结束时间（毫秒）。" }, "every_hour": { "type": "integer", "description": "弹出频率：每 N 小时。由 extra.every_hour 带出。" }, "pop_time": { "type": "integer", "description": "弹出次数上限。由 extra.pop_time 带出。" }, "home_status": { "type": "integer", "description": "首页场景是否生效：0/1。", "enum": [ 0, 1 ] }, "foryou_status": { "type": "integer", "description": "foryou 场景是否生效：0/1。", "enum": [ 0, 1 ] }, "play_status": { "type": "integer", "description": "播放器场景是否生效：0/1。", "enum": [ 0, 1 ] } } } }, "HomePopupItem": { "type": "object", "description": "First page popup item returned by getFistPagePopV3.", "properties": { "id": { "type": "integer", "description": "Popup id." }, "config_id": { "type": "integer", "description": "Popup config id." }, "source_config_id": { "type": "integer", "description": "Source config id." }, "recommend_name": { "type": "string", "description": "Popup title." }, "image": { "type": "string", "description": "Popup image URL." }, "cover": { "type": "string", "description": "Series cover URL." }, "series_name": { "type": "string", "description": "Series name." }, "jump_type": { "type": "string", "description": "Jump type.", "enum": [ "play", "open_url", "inner_url", "rand_series" ] }, "jump_value": { "type": "string", "description": "Jump target value." }, "pop_up_style": { "type": "integer", "description": "Popup style." }, "url": { "type": "string", "description": "URL for open_url or inner_url." }, "series_id": { "type": "integer", "description": "Target series id." }, "is_collect": { "type": "integer", "description": "Whether collected: 0/1.", "enum": [ 0, 1 ] }, "tags": { "type": "array", "description": "Reserved tag list.", "items": { "type": "object", "additionalProperties": true } }, "end_time": { "type": "integer", "description": "End time in milliseconds." }, "every_hour": { "type": "integer", "description": "Popup interval hours." }, "pop_time": { "type": "integer", "description": "Popup count limit in interval." }, "daily_limit": { "type": "integer", "description": "Daily exposure limit." }, "trace_id": { "type": "string", "description": "Trace id to report with reportHomePopupEvent." }, "request_id": { "type": "string", "description": "Popup request id for client tracking. Same as trace_id." }, "home_status": { "type": "integer", "description": "Home scene status: 0/1.", "enum": [ 0, 1 ] }, "foryou_status": { "type": "integer", "description": "ForYou scene status: 0/1.", "enum": [ 0, 1 ] }, "play_status": { "type": "integer", "description": "Player scene status: 0/1.", "enum": [ 0, 1 ] } } }, "HomePopupEventReportResult": { "type": "object", "description": "Home popup event report result. Exposure returns preloaded next popup.", "properties": { "next_popup": { "description": "Preloaded next popup. Empty object when no popup is available.", "allOf": [ { "$ref": "#/components/schemas/HomePopupItem" } ] } } }, "ListPage": { "type": "object", "properties": { "paging": { "type": "object", "description": "分页信息。", "properties": { "page_no": { "type": "integer", "description": "当前页码，从 1 开始。" }, "page_size": { "type": "integer", "description": "接口实际采用的每页条数。" }, "total": { "type": "integer", "description": "满足当前接口查询条件的记录总数，不是总页数。" } }, "required": [ "page_no", "page_size", "total" ] }, "list": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "CommentSectionCountList": { "type": "object", "properties": { "list": { "type": "array", "items": { "type": "object", "properties": { "series_no": { "type": "integer" }, "total_comment_num": { "type": "integer" }, "total_comment_num_str": { "type": "string" } } } } } }, "ResourcePositionItem": { "type": "object", "description": "单个资源位投放配置。", "properties": { "id": { "type": "integer", "description": "投放配置 ID。" }, "slot_code": { "type": "string", "description": "资源位编码。" }, "resource_name": { "type": "string", "description": "资源名称。" }, "title": { "type": "string", "description": "展示标题。" }, "icon": { "type": "string", "description": "图标完整 URL；静态图为图片地址，Lottie 为 JSON 文件地址。" }, "icon_type": { "type": "string", "description": "图标类型，由文件后缀自动识别：image=静态图片，lottie=Lottie 动画 JSON。", "enum": [ "image", "lottie" ] }, "tip": { "type": "string", "description": "提示文案。" }, "jump_type": { "type": "string", "description": "跳转类型，如 turbolink_task_center。" }, "jump_config": { "type": "object", "description": "分档位跳转配置，key 为 default/test/T1/T2/T3。", "additionalProperties": { "type": "string" } }, "jump_url": { "type": "string", "description": "后端解析后的最终跳转链接。" }, "scene_tag": { "type": "string", "description": "本次资源位命中的消费档位标识，用于前端埋点；取值如 default、test、T1、T2、T3。" }, "page_codes": { "type": "array", "description": "启用页面编码列表，空数组表示不限页面。可选值：index、index_group、play、detail、short_episode、search、tag_filter、tag_detail、all_tags、profile。", "items": { "type": "string" } }, "weight": { "type": "integer", "description": "权重。" } } }, "ResourcePositionMap": { "type": "object", "description": "官网资源位投放结果，按资源位编码平铺在 data 下；每个 key 对应一条配置或 null。", "properties": { "incentive_task_nav": { "nullable": true, "description": "资源位投放配置；无命中投放时为 null。", "allOf": [ { "$ref": "#/components/schemas/ResourcePositionItem" } ] }, "banner_bottom_bar": { "nullable": true, "description": "资源位投放配置；无命中投放时为 null。", "allOf": [ { "$ref": "#/components/schemas/ResourcePositionItem" } ] }, "card_float": { "nullable": true, "description": "资源位投放配置；无命中投放时为 null。", "allOf": [ { "$ref": "#/components/schemas/ResourcePositionItem" } ] }, "profile_homepage": { "nullable": true, "description": "资源位投放配置；无命中投放时为 null。", "allOf": [ { "$ref": "#/components/schemas/ResourcePositionItem" } ] } } }, "TurbolinkWebUserInfo": { "type": "object", "description": "TurboLink 用户信息，coin_num 表示 Bonus 余额。", "properties": { "coin_num": { "type": "integer", "description": "用户 Bonus 余额。" }, "username": { "type": "string", "description": "用户名。" }, "avatar_url": { "type": "string", "description": "用户头像 URL。" } } }, "TurbolinkWebDeductBonus": { "type": "object", "description": "TurboLink 积分扣减/兑换结果。", "properties": { "state": { "type": "string", "description": "处理结果：success=成功，lack=失败（如余额不足）。", "enum": [ "success", "lack" ] }, "relate_id": { "type": "string", "description": "幂等关联 ID，对应请求中的 deduct_id 或 gain_id。" } } }, "TurbolinkWebCallbackText": { "type": "string", "description": "奖品发放回调结果纯文本。注意：webCallback 实际 HTTP Body 为纯文本 success 或 fail，不经过标准 JSON 包装；此处为 data 字段语义说明。", "enum": [ "success", "fail" ], "example": "success" } } } }