{
    "openapi": "3.0.3",
    "info": {
        "title": "Mall API",
        "version": "1.0.0",
        "description": "Automatically generated from ThinkPHP mallapi routes."
    },
    "servers": [
        {
            "url": "/"
        }
    ],
    "tags": [
        {
            "name": "原生播放模块",
            "description": "独立获取未加密 HLS 签名链接。"
        },
        {
            "name": "AES-128 加密播放模块",
            "description": "独立加密播放地址与播放器鉴权取密钥接口。"
        },
        {
            "name": "用户模块",
            "description": "注册登录、用户资料、观看历史。"
        },
        {
            "name": "短剧模块",
            "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。"
        },
        {
            "name": "充值模块",
            "description": "会员、K 币、买断等充值套餐。"
        },
        {
            "name": "支付模块",
            "description": "支付币种、订单创建、网关回调和单集解锁。"
        },
        {
            "name": "iOS 内购模块",
            "description": "StoreKit 商品、订单、Apple 验单和服务端通知。"
        },
        {
            "name": "Google Play 内购模块",
            "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。"
        },
        {
            "name": "公共模板",
            "description": "客户端公共基础数据和公共页面模板，包括可用语言、热搜词及关于我们等内容页。"
        },
        {
            "name": "评论管理",
            "description": "评论举报及其类型配置。"
        }
    ],
    "x-legacy-tags": [
        {
            "name": "User",
            "description": "用户接口"
        },
        {
            "name": "Drama",
            "description": "短剧接口"
        },
        {
            "name": "Pay",
            "description": "支付接口"
        }
    ],
    "components": {
        "securitySchemes": {
            "Authorization": {
                "type": "apiKey",
                "in": "header",
                "name": "Authorization"
            }
        }
    },
    "paths": {
        "/mallapi/app-download/configs": {
            "get": {
                "tags": [
                    "其他模块"
                ],
                "summary": "短剧列表",
                "description": "请参考参数说明和响应结果，业务响应统一使用 code、msg、data 结构。",
                "operationId": "app_mallapi_controller_AppDownloadController_index",
                "x-module": {
                    "key": "AppDownloadController",
                    "name": "其他模块",
                    "description": "未归类接口。",
                    "order": 999
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/content-page/{pageType}": {
            "get": {
                "tags": [
                    "公共模板"
                ],
                "summary": "获取公共内容页",
                "description": "给客户端展示关于我们、联系我们、隐私政策和服务条款等公共模板页面使用，按页面类型和请求语言返回后台配置的富文本内容。",
                "operationId": "app_mallapi_controller_ContentPageController_show",
                "x-module": {
                    "key": "public-template",
                    "name": "公共模板",
                    "description": "客户端公共基础数据和公共页面模板，包括可用语言、热搜词及关于我们等内容页。",
                    "order": 55
                },
                "parameters": [
                    {
                        "name": "pageType",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "",
                        "description": "公共内容页类型：about 关于我们、contact 联系我们、privacy 隐私政策、terms 服务条款。"
                    },
                    {
                        "name": "lang",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "zh-CN",
                                "en",
                                "ja"
                            ]
                        },
                        "example": "zh-CN",
                        "description": "返回文案语言，可传 zh-CN、en 或 ja；也可以使用 language、locale 参数或 Accept-Language 请求头。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "page_type": {
                                                    "type": "string",
                                                    "example": "privacy"
                                                },
                                                "content": {
                                                    "type": "string",
                                                    "example": "<p>隐私政策内容</p>"
                                                },
                                                "lang": {
                                                    "type": "string",
                                                    "example": "zh-CN"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "page_type": "about",
                                        "content": "<p>关于我们</p>",
                                        "lang": "zh-CN"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "短剧列表",
                "description": "分页查询短剧，支持标题或简介模糊搜索、分类、推荐、轮播和排序筛选。category_ids 为分类 ID 数组，后端根据分类树的 parent_id 自动识别一级或二级分类；传一级分类时匹配该分类及其全部子分类。不传分类参数时不进行分类筛选。",
                "operationId": "app_mallapi_controller_DramaController_index",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "title",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "短剧",
                        "description": "短剧标题或简介关键字，支持模糊匹配。"
                    },
                    {
                        "name": "sort",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "",
                        "description": "排序方式，例如 hot、latest、default。"
                    },
                    {
                        "name": "is_recommend",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "是否首页推荐，1 表示是。"
                    },
                    {
                        "name": "is_banner",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "是否轮播推荐，1 表示是。"
                    },
                    {
                        "name": "category_ids",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "array",
                            "items": {
                                "type": "integer"
                            }
                        },
                        "example": [
                            1,
                            2
                        ],
                        "description": "分类 ID 数组，可传 category_ids[]=1&category_ids[]=2。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/categories": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "短剧分类",
                "description": "获取启用中的短剧分类树，用于搜索页和列表筛选。返回字段及层级保持原接口定义：一级分组及顺序保留，children 中过滤自身及启用的后代分类均无上架短剧的分类项；有上架短剧但封面为空的分类仍保留。不新增封面字段，不给叶子分类增加 children 字段。分类封面继续调用既有短剧列表接口，按默认 sort 降序、id 降序取首部剧的封面。顶层一级分类的 parent_id=0（通常 level=1）；不区分另设一级/二级接口。",
                "operationId": "app_mallapi_controller_DramaController_categories",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/collects": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "收藏记录列表",
                "description": "分页查询当前用户收藏过的剧集或短剧。",
                "operationId": "app_mallapi_controller_DramaController_collectList",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/collects/batch-cancel": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "批量取消收藏",
                "description": "根据剧集 ID 数组批量取消当前用户已有的收藏。重复 ID 会自动去重，不存在或已取消的记录会被忽略；单次最多 100 个。",
                "operationId": "app_mallapi_controller_DramaController_batchCancelCollects",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "requested_count": 2,
                                        "canceled_count": 2,
                                        "episode_ids": [
                                            1,
                                            2
                                        ]
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "episode_ids"
                                ],
                                "properties": {
                                    "episode_ids": {
                                        "type": "array",
                                        "example": [
                                            1,
                                            2
                                        ],
                                        "description": "剧集 ID 数组；重复 ID 自动去重，单次最多 100 个。",
                                        "items": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/comments/report-reasons": {
            "get": {
                "tags": [
                    "评论管理"
                ],
                "summary": "获取评论举报类型",
                "description": "读取后台启用的评论举报类型，并按当前请求语言返回名称。接口会在列表末尾追加系统固定的 other 补充说明项，客户端无需自行拼接。本接口无需登录。",
                "operationId": "app_mallapi_controller_DramaController_commentReportReasons",
                "x-module": {
                    "key": "comment-management",
                    "name": "评论管理",
                    "description": "评论举报及其类型配置。",
                    "order": 25
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": [
                                        {
                                            "code": "abuse",
                                            "name": "辱骂骚扰"
                                        },
                                        {
                                            "code": "other",
                                            "name": "其他"
                                        }
                                    ]
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/comments/upload-image": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "上传评论图片",
                "description": "上传评论配图。默认 type=single，保持单图返回结构；传 type=multi 并提交 images[] 时逐张上传，返回每张图片的成功/失败状态。单张最大 10MB，一次最多 4 张，支持 JPG、PNG、GIF、WEBP。",
                "operationId": "app_mallapi_controller_DramaController_uploadCommentImage",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": false,
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "type": "object",
                                "required": [],
                                "properties": {
                                    "type": {
                                        "type": "string",
                                        "enum": [
                                            "single",
                                            "multi"
                                        ],
                                        "default": "single",
                                        "description": "上传模式：single（默认，兼容旧单图返回）或 multi（批量返回）。"
                                    },
                                    "image": {
                                        "type": "string",
                                        "format": "binary",
                                        "description": "单图字段；也兼容 file 字段。type=single 时使用。"
                                    },
                                    "file": {
                                        "type": "string",
                                        "format": "binary",
                                        "description": "单图兼容字段。type=single 时使用。"
                                    },
                                    "images[]": {
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "format": "binary"
                                        },
                                        "description": "批量图片字段。type=multi 时使用，一次最多 4 张。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/comments/{commentId}": {
            "delete": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "删除评论",
                "description": "删除当前用户有权限删除的评论。",
                "operationId": "app_mallapi_controller_DramaController_deleteComment",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "commentId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "评论 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/comments/{commentId}/like": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "点赞/取消点赞评论",
                "description": "切换当前用户对评论的点赞状态。",
                "operationId": "app_mallapi_controller_DramaController_toggleCommentLike",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "commentId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "评论 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/comments/{commentId}/replies": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "评论回复列表",
                "description": "查询指定评论下的回复列表。",
                "operationId": "app_mallapi_controller_DramaController_commentReplyList",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "commentId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "评论 ID。"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/comments/{commentId}/reports": {
            "post": {
                "tags": [
                    "评论管理"
                ],
                "summary": "提交评论举报",
                "description": "对指定评论或回复提交举报，无需登录。可选传入 Authorization 以关联登录账号；未登录或令牌失效时按游客受理，举报人 ID 为 0。reason_code 必须是后台启用类型的编码或固定值 other；选择 other 时 reason_text 必填，最长 200 个字符。同一登录用户对同一评论存在待审核举报时按幂等成功返回；游客举报独立受理，不按账号合并。",
                "operationId": "app_mallapi_controller_DramaController_reportComment",
                "x-module": {
                    "key": "comment-management",
                    "name": "评论管理",
                    "description": "评论举报及其类型配置。",
                    "order": 25
                },
                "parameters": [
                    {
                        "name": "commentId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "评论 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "可选 Bearer <token>，用于关联登录账号；不传或令牌失效时按游客受理。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "举报已提交",
                                    "data": {
                                        "id": 12,
                                        "comment_id": 345,
                                        "status": "pending",
                                        "duplicated": 0
                                    }
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "reason_code"
                                ],
                                "properties": {
                                    "reason_code": {
                                        "type": "string",
                                        "example": "abuse",
                                        "description": "举报原因编码：传后台“获取评论举报类型”接口返回的启用编码，或固定值 other。"
                                    },
                                    "reason_text": {
                                        "type": "string",
                                        "example": "存在辱骂性内容",
                                        "description": "举报补充说明；reason_code=other 时必填，最长 200 个字符。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/episode/{episodeId}": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "剧集详情",
                "description": "获取单集信息、封面、付费状态和互动统计。",
                "operationId": "app_mallapi_controller_DramaController_episodeDetail",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "episodeId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "剧集 ID。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/episode/{episodeId}/collect": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "收藏/取消收藏剧集",
                "description": "切换当前用户对剧集的收藏状态，并返回新的收藏数量。",
                "operationId": "app_mallapi_controller_DramaController_toggleEpisodeCollect",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "episodeId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "剧集 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/episode/{episodeId}/comments": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "评论列表",
                "description": "分页查询指定剧集的评论。",
                "operationId": "app_mallapi_controller_DramaController_commentList",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "episodeId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "剧集 ID。"
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "reply_limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "每条评论默认带出的回复数量，不传时默认 3 条。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "发布评论",
                "description": "给指定剧集发布评论，支持回复和图片。",
                "operationId": "app_mallapi_controller_DramaController_createComment",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "episodeId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "剧集 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "content"
                                ],
                                "properties": {
                                    "content": {
                                        "type": "string",
                                        "example": "",
                                        "description": "评论正文。"
                                    },
                                    "parent_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "父评论 ID，回复评论时传。"
                                    },
                                    "image_urls": {
                                        "type": "array",
                                        "example": [
                                            "https://example.com/comment-image.png"
                                        ],
                                        "description": "评论图片 URL 列表，支持数组；用于提交多张评论配图。",
                                        "items": {
                                            "type": "string"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/episode/{episodeId}/like": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "点赞/取消点赞剧集",
                "description": "切换当前用户对剧集的点赞状态，并返回新的点赞数量。",
                "operationId": "app_mallapi_controller_DramaController_toggleEpisodeLike",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "episodeId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "剧集 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/likes": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "点赞记录列表",
                "description": "分页查询当前用户点赞过的剧集或短剧。",
                "operationId": "app_mallapi_controller_DramaController_likeList",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/drama/likes/batch-cancel": {
            "post": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "批量取消点赞",
                "description": "根据剧集 ID 数组批量取消当前用户已有的点赞。重复 ID 会自动去重，不存在或已取消的记录会被忽略；单次最多 100 个。",
                "operationId": "app_mallapi_controller_DramaController_batchCancelLikes",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "requested_count": 2,
                                        "canceled_count": 2,
                                        "episode_ids": [
                                            1,
                                            2
                                        ]
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "episode_ids"
                                ],
                                "properties": {
                                    "episode_ids": {
                                        "type": "array",
                                        "example": [
                                            1,
                                            2
                                        ],
                                        "description": "剧集 ID 数组；重复 ID 自动去重，单次最多 100 个。",
                                        "items": {
                                            "type": "integer"
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/playInfo/{videoId}": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "获取播放信息",
                "description": "根据视频 ID 获取阿里云 VOD 播放凭证或播放信息。",
                "operationId": "app_mallapi_controller_DramaController_getPlayInfo",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "videoId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "video-id",
                        "description": "阿里云 VOD 视频 ID。"
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "",
                        "description": "验证码类型：phone 或 email。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/{dramaId}/episodes": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "剧集列表",
                "description": "获取指定短剧下的所有剧集。",
                "operationId": "app_mallapi_controller_DramaController_episodeList",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "dramaId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "短剧 ID。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/{id}": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "短剧详情",
                "description": "获取短剧基础信息、分类、统计数据和剧集列表。",
                "operationId": "app_mallapi_controller_DramaController_read",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "资源 ID，路径中的通用主键。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/drama/{id}/playback-startup": {
            "get": {
                "tags": [
                    "短剧模块"
                ],
                "summary": "H5 播放启动信息",
                "description": "一次返回 drama、record、episode_id、play_info、play_error。可选 episode_id 优先于观看历史；未解锁剧集返回详情但不签发播放凭证。登录用户按自己的权益和历史解析，响应不得被公共缓存。",
                "operationId": "app_mallapi_controller_DramaController_playbackStartup",
                "x-module": {
                    "key": "DramaController",
                    "name": "短剧模块",
                    "description": "短剧列表、详情、剧集、播放、点赞收藏和评论。",
                    "order": 20
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "资源 ID，路径中的通用主键。"
                    },
                    {
                        "name": "episode_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "剧集 ID。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/google-play/notifications": {
            "post": {
                "tags": [
                    "Google Play 内购模块"
                ],
                "summary": "Google Play 服务端通知",
                "description": "仅供 Google Cloud Pub/Sub 的鉴权 push subscription 调用，Authorization 必须是 Google 签发的 OIDC Bearer JWT；客户端不得调用。服务端校验包名、保存通知并重新查询 Google。",
                "operationId": "app_mallapi_controller_GooglePlayController_notifications",
                "x-module": {
                    "key": "GooglePlayController",
                    "name": "Google Play 内购模块",
                    "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。",
                    "order": 46
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "Bearer <Google-signed OIDC JWT>",
                        "description": "Pub/Sub 鉴权 push subscription 提供的 Google 签发 OIDC JWT，不使用用户登录 token。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "message": {
                                            "type": "string",
                                            "example": "accepted"
                                        }
                                    }
                                },
                                "example": {
                                    "message": "accepted"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "通知鉴权失败或数据无效",
                        "content": {
                            "application/json": {
                                "example": {
                                    "message": "Invalid notification"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "处理暂时失败，Pub/Sub 可重试",
                        "content": {
                            "application/json": {
                                "example": {
                                    "message": "Notification temporarily unavailable"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "message"
                                ],
                                "properties": {
                                    "message": {
                                        "type": "object",
                                        "required": [
                                            "messageId",
                                            "data"
                                        ],
                                        "description": "Google Cloud Pub/Sub push 消息。",
                                        "properties": {
                                            "messageId": {
                                                "type": "string",
                                                "example": "pubsub-message-id",
                                                "description": "Pub/Sub 消息去重 ID。"
                                            },
                                            "data": {
                                                "type": "string",
                                                "example": "eyJwYWNrYWdlTmFtZSI6Ii4uLiJ9",
                                                "description": "Base64编码的Google通知，包含packageName及subscriptionNotification、oneTimeProductNotification、voidedPurchaseNotification或testNotification。"
                                            }
                                        }
                                    },
                                    "subscription": {
                                        "type": "string",
                                        "example": "projects/example/subscriptions/google-play-push",
                                        "description": "Pub/Sub subscription 名称，可由 Google 附带。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/google-play/order": {
            "post": {
                "tags": [
                    "Google Play 内购模块"
                ],
                "summary": "创建 Google Play 内购订单",
                "description": "一次性按商品ID创建订单；自动续费另需base_plan_id与idempotency_key，同一购买意向重试保持键不变。丢失旧键时，同账号、商品及基础方案会复用原待支付订单，新旧键均保持幂等；以返回的order_no为准。订阅返回can_start_purchase及next_action：purchase可继续原购买意向；restore表示已有平台待付款绑定，须查询SUBS并恢复，不能再次发起付款；none表示原单已付款或关闭，按status处理。App使用obfuscated_account_id绑定账号，自动续费选择SUBS及匹配基础方案的offerToken。每次购买前先查询INAPP/SUBS恢复未完成购买，即使can_start_purchase为true也不能跳过。已有固定会员或其他平台有效订阅会拦截新首购；替换本人Google订阅须明确原订阅ID并使用Google官方替换流程。",
                "operationId": "app_mallapi_controller_GooglePlayController_order",
                "x-module": {
                    "key": "GooglePlayController",
                    "name": "Google Play 内购模块",
                    "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。",
                    "order": 46
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码，200 为成功，其他值为错误。"
                                        },
                                        "msg": {
                                            "type": "string",
                                            "description": "英文业务说明。"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "order_no": {
                                                    "type": "string",
                                                    "description": "本站 Google Play 订单号。"
                                                },
                                                "original_order_no": {
                                                    "type": "string",
                                                    "description": "原购买意向订单号；关闭后补记付款仍可反查原单。"
                                                },
                                                "paid_order_no": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "关联付款订单号；查原关闭单可得到补记付款单，未查到付款时为null。订阅原关闭单指向当前最近核验付款。"
                                                },
                                                "purchase_state": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "一次性最近核验状态：PENDING、CANCELLED、PURCHASED；尚未登记或订阅为null。PENDING不发货，官方核验CANCELLED才关闭待付订单；关闭后有效付款保留原单并补记新付款单。"
                                                },
                                                "product_id": {
                                                    "type": "string",
                                                    "description": "Play Console 商品 ID。"
                                                },
                                                "obfuscated_account_id": {
                                                    "type": "string",
                                                    "description": "App 发起 BillingFlow 时设置的账号绑定值。"
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "订单状态：0 待支付、1 已支付、2 已关闭。"
                                                },
                                                "coin_amount": {
                                                    "type": "integer",
                                                    "description": "订单快照中的 K 币数量。"
                                                },
                                                "member_days": {
                                                    "type": "integer",
                                                    "description": "订单快照中的会员天数。"
                                                },
                                                "delivery_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "review",
                                                        "delivered",
                                                        "revoked"
                                                    ],
                                                    "description": "权益状态；delivered 表示到账。"
                                                },
                                                "consume_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "retry",
                                                        "done",
                                                        "revoked",
                                                        "not_applicable"
                                                    ],
                                                    "description": "一次性商品消费状态；订阅为not_applicable，严禁consume。"
                                                },
                                                "refund_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "none",
                                                        "review",
                                                        "revoked"
                                                    ],
                                                    "description": "退款状态；review 需要人工审核。"
                                                },
                                                "paid_at": {
                                                    "type": "string",
                                                    "description": "本站记录的支付时间；待支付时为空字符串。"
                                                },
                                                "purchase_kind": {
                                                    "type": "string",
                                                    "description": "auto_renewable为订阅；原一次性商品可能返回one_time或旧值。"
                                                },
                                                "base_plan_id": {
                                                    "type": "string",
                                                    "description": "Google基础方案ID。"
                                                },
                                                "subscription_id": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "Google订阅购买记录ID，与Apple ID空间独立。"
                                                },
                                                "chain_key": {
                                                    "type": "string",
                                                    "description": "本地Google订阅整链标识。"
                                                },
                                                "acknowledge_status": {
                                                    "type": "string",
                                                    "description": "pending、retry、done或not_applicable；订阅永远不consume。"
                                                },
                                                "trace_id": {
                                                    "type": "string",
                                                    "description": "支持后台定位异常的追踪号。"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "失败的稳定原因码，不能据此判断未扣款。"
                                                },
                                                "next_action": {
                                                    "type": "string",
                                                    "description": "Google下单：purchase表示继续原意向，restore表示查询INAPP/SUBS恢复待付或未消费购买，none表示原意向已付款且收尾完成或已关闭。失败时retry表示复用原凭证重试，contact_support表示核对归属或联系支持。"
                                                },
                                                "can_start_purchase": {
                                                    "type": "boolean",
                                                    "description": "Google下单成功时返回；false时不得发起BillingFlow。true也须先查询INAPP/SUBS恢复商店未完成购买，不能只凭本地尚无绑定判定Google未扣款。"
                                                },
                                                "subscription": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "Google订阅状态摘要，含status、expires_at、auto_renew_status、acknowledge_status、manage_url。"
                                                },
                                                "membership": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "两平台统一会员计算结果；固定时长仅在无有效订阅时消耗。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Order created",
                                    "data": {
                                        "order_no": "GP202610231430001234567890AB",
                                        "product_id": "coins_100",
                                        "obfuscated_account_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0",
                                        "status": 0,
                                        "coin_amount": 100,
                                        "member_days": 0,
                                        "delivery_status": "pending",
                                        "consume_status": "pending",
                                        "refund_status": "none",
                                        "paid_at": ""
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "product_id"
                                ],
                                "properties": {
                                    "product_id": {
                                        "type": "string",
                                        "description": "Google商品ID，取自商品列表。"
                                    },
                                    "base_plan_id": {
                                        "type": "string",
                                        "description": "自动续费必填基础方案ID；一次性商品留空。"
                                    },
                                    "idempotency_key": {
                                        "type": "string",
                                        "minLength": 16,
                                        "maxLength": 128,
                                        "description": "自动续费必填；一次性商品推荐传入。有键时同一次购买意向重试保持不变，付款/消费/关闭后仍返回原单；一次性不传仅兼容待付/未消费订单复用，不保证消费完成后的重试不会新建单。"
                                    },
                                    "replacement_subscription_id": {
                                        "type": "integer",
                                        "description": "本人有效Google订阅的替换购买，填原订阅ID；App同时传旧token及替换参数。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/google-play/order/{orderNo}": {
            "get": {
                "tags": [
                    "Google Play 内购模块"
                ],
                "summary": "查询 Google Play 内购订单",
                "description": "仅返回当前登录用户的 Google Play 订单；status 为本站订单状态，delivery_status、consume_status 和 refund_status 分别表示权益发放、商品消费和退款审核状态。",
                "operationId": "app_mallapi_controller_GooglePlayController_orderStatus",
                "x-module": {
                    "key": "GooglePlayController",
                    "name": "Google Play 内购模块",
                    "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。",
                    "order": 46
                },
                "parameters": [
                    {
                        "name": "orderNo",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "GP202610231430001234567890AB",
                        "description": "本站订单号，仅能查询当前登录用户的订单。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码，200 为成功，其他值为错误。"
                                        },
                                        "msg": {
                                            "type": "string",
                                            "description": "英文业务说明。"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "order_no": {
                                                    "type": "string",
                                                    "description": "本站 Google Play 订单号。"
                                                },
                                                "original_order_no": {
                                                    "type": "string",
                                                    "description": "原购买意向订单号；关闭后补记付款仍可反查原单。"
                                                },
                                                "paid_order_no": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "关联付款订单号；查原关闭单可得到补记付款单，未查到付款时为null。订阅原关闭单指向当前最近核验付款。"
                                                },
                                                "purchase_state": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "一次性最近核验状态：PENDING、CANCELLED、PURCHASED；尚未登记或订阅为null。PENDING不发货，官方核验CANCELLED才关闭待付订单；关闭后有效付款保留原单并补记新付款单。"
                                                },
                                                "product_id": {
                                                    "type": "string",
                                                    "description": "Play Console 商品 ID。"
                                                },
                                                "obfuscated_account_id": {
                                                    "type": "string",
                                                    "description": "App 发起 BillingFlow 时设置的账号绑定值。"
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "订单状态：0 待支付、1 已支付、2 已关闭。"
                                                },
                                                "coin_amount": {
                                                    "type": "integer",
                                                    "description": "订单快照中的 K 币数量。"
                                                },
                                                "member_days": {
                                                    "type": "integer",
                                                    "description": "订单快照中的会员天数。"
                                                },
                                                "delivery_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "review",
                                                        "delivered",
                                                        "revoked"
                                                    ],
                                                    "description": "权益状态；delivered 表示到账。"
                                                },
                                                "consume_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "retry",
                                                        "done",
                                                        "revoked",
                                                        "not_applicable"
                                                    ],
                                                    "description": "一次性商品消费状态；订阅为not_applicable，严禁consume。"
                                                },
                                                "refund_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "none",
                                                        "review",
                                                        "revoked"
                                                    ],
                                                    "description": "退款状态；review 需要人工审核。"
                                                },
                                                "paid_at": {
                                                    "type": "string",
                                                    "description": "本站记录的支付时间；待支付时为空字符串。"
                                                },
                                                "purchase_kind": {
                                                    "type": "string",
                                                    "description": "auto_renewable为订阅；原一次性商品可能返回one_time或旧值。"
                                                },
                                                "base_plan_id": {
                                                    "type": "string",
                                                    "description": "Google基础方案ID。"
                                                },
                                                "subscription_id": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "Google订阅购买记录ID，与Apple ID空间独立。"
                                                },
                                                "chain_key": {
                                                    "type": "string",
                                                    "description": "本地Google订阅整链标识。"
                                                },
                                                "acknowledge_status": {
                                                    "type": "string",
                                                    "description": "pending、retry、done或not_applicable；订阅永远不consume。"
                                                },
                                                "trace_id": {
                                                    "type": "string",
                                                    "description": "支持后台定位异常的追踪号。"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "失败的稳定原因码，不能据此判断未扣款。"
                                                },
                                                "next_action": {
                                                    "type": "string",
                                                    "description": "Google下单：purchase表示继续原意向，restore表示查询INAPP/SUBS恢复待付或未消费购买，none表示原意向已付款且收尾完成或已关闭。失败时retry表示复用原凭证重试，contact_support表示核对归属或联系支持。"
                                                },
                                                "can_start_purchase": {
                                                    "type": "boolean",
                                                    "description": "Google下单成功时返回；false时不得发起BillingFlow。true也须先查询INAPP/SUBS恢复商店未完成购买，不能只凭本地尚无绑定判定Google未扣款。"
                                                },
                                                "subscription": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "Google订阅状态摘要，含status、expires_at、auto_renew_status、acknowledge_status、manage_url。"
                                                },
                                                "membership": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "两平台统一会员计算结果；固定时长仅在无有效订阅时消耗。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Success",
                                    "data": {
                                        "order_no": "GP202610231430001234567890AB",
                                        "product_id": "coins_100",
                                        "obfuscated_account_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0",
                                        "status": 1,
                                        "coin_amount": 100,
                                        "member_days": 0,
                                        "delivery_status": "delivered",
                                        "consume_status": "done",
                                        "refund_status": "none",
                                        "paid_at": "2026-10-23 14:30:00"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/google-play/products": {
            "get": {
                "tags": [
                    "Google Play 内购模块"
                ],
                "summary": "Google Play 内购商品列表",
                "description": "返回已启用套餐的 Google Play 商品 ID 和权益；商品售价及币种由 Android App 通过 BillingClient 读取。",
                "operationId": "app_mallapi_controller_GooglePlayController_products",
                "x-module": {
                    "key": "GooglePlayController",
                    "name": "Google Play 内购模块",
                    "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。",
                    "order": 46
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码，200 为成功，其他值为错误。"
                                        },
                                        "msg": {
                                            "type": "string",
                                            "description": "英文业务说明。"
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "product_id": {
                                                        "type": "string",
                                                        "description": "Play Console 商品 ID。"
                                                    },
                                                    "template_id": {
                                                        "type": "integer",
                                                        "description": "充值套餐 ID。"
                                                    },
                                                    "template_type": {
                                                        "type": "integer",
                                                        "description": "1为会员（含自动续费），2为K币。"
                                                    },
                                                    "purchase_kind": {
                                                        "type": "string",
                                                        "enum": [
                                                            "one_time",
                                                            "auto_renewable"
                                                        ],
                                                        "description": "决定BillingClient使用INAPP还是SUBS。"
                                                    },
                                                    "base_plan_id": {
                                                        "type": "string",
                                                        "description": "Google订阅基础方案ID；App选取匹配的offerToken。"
                                                    },
                                                    "subscription_period": {
                                                        "type": "string",
                                                        "description": "month或year；实际权益起止由Google核验。"
                                                    },
                                                    "name": {
                                                        "type": "string",
                                                        "description": "套餐名称。"
                                                    },
                                                    "coin_amount": {
                                                        "type": "integer",
                                                        "description": "发放 K 币数量。"
                                                    },
                                                    "member_days": {
                                                        "type": "integer",
                                                        "description": "发放会员天数。"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Success",
                                    "data": [
                                        {
                                            "product_id": "coins_100",
                                            "template_id": 1,
                                            "template_type": 2,
                                            "name": "100 K币",
                                            "coin_amount": 100,
                                            "member_days": 0
                                        }
                                    ]
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/google-play/verify": {
            "post": {
                "tags": [
                    "Google Play 内购模块"
                ],
                "summary": "Google Play 购买验单与订阅恢复",
                "description": "默认verify提交订单号、商品ID与purchaseToken；订阅restore/refresh只需原凭证，仍核对登录账号归属。待支付不发权益。自动续费按官方付款订单幂等记录并重算实际会员区间，新购买需要时acknowledge，订阅永不consume。200只代表处理成功，当前是否VIP以membership为准；取消续费保留本期，退款逐期处理。失败保留reason_code和trace_id。",
                "operationId": "app_mallapi_controller_GooglePlayController_verify",
                "x-module": {
                    "key": "GooglePlayController",
                    "name": "Google Play 内购模块",
                    "description": "Android 商品、订单、Google 验单及 Pub/Sub 服务端通知。",
                    "order": 46
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码，200 为成功，其他值为错误。"
                                        },
                                        "msg": {
                                            "type": "string",
                                            "description": "英文业务说明。"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "order_no": {
                                                    "type": "string",
                                                    "description": "本站 Google Play 订单号。"
                                                },
                                                "original_order_no": {
                                                    "type": "string",
                                                    "description": "原购买意向订单号；关闭后补记付款仍可反查原单。"
                                                },
                                                "paid_order_no": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "关联付款订单号；查原关闭单可得到补记付款单，未查到付款时为null。订阅原关闭单指向当前最近核验付款。"
                                                },
                                                "purchase_state": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "一次性最近核验状态：PENDING、CANCELLED、PURCHASED；尚未登记或订阅为null。PENDING不发货，官方核验CANCELLED才关闭待付订单；关闭后有效付款保留原单并补记新付款单。"
                                                },
                                                "product_id": {
                                                    "type": "string",
                                                    "description": "Play Console 商品 ID。"
                                                },
                                                "obfuscated_account_id": {
                                                    "type": "string",
                                                    "description": "App 发起 BillingFlow 时设置的账号绑定值。"
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "订单状态：0 待支付、1 已支付、2 已关闭。"
                                                },
                                                "coin_amount": {
                                                    "type": "integer",
                                                    "description": "订单快照中的 K 币数量。"
                                                },
                                                "member_days": {
                                                    "type": "integer",
                                                    "description": "订单快照中的会员天数。"
                                                },
                                                "delivery_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "review",
                                                        "delivered",
                                                        "revoked"
                                                    ],
                                                    "description": "权益状态；delivered 表示到账。"
                                                },
                                                "consume_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "pending",
                                                        "retry",
                                                        "done",
                                                        "revoked",
                                                        "not_applicable"
                                                    ],
                                                    "description": "一次性商品消费状态；订阅为not_applicable，严禁consume。"
                                                },
                                                "refund_status": {
                                                    "type": "string",
                                                    "enum": [
                                                        "none",
                                                        "review",
                                                        "revoked"
                                                    ],
                                                    "description": "退款状态；review 需要人工审核。"
                                                },
                                                "paid_at": {
                                                    "type": "string",
                                                    "description": "本站记录的支付时间；待支付时为空字符串。"
                                                },
                                                "purchase_kind": {
                                                    "type": "string",
                                                    "description": "auto_renewable为订阅；原一次性商品可能返回one_time或旧值。"
                                                },
                                                "base_plan_id": {
                                                    "type": "string",
                                                    "description": "Google基础方案ID。"
                                                },
                                                "subscription_id": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "Google订阅购买记录ID，与Apple ID空间独立。"
                                                },
                                                "chain_key": {
                                                    "type": "string",
                                                    "description": "本地Google订阅整链标识。"
                                                },
                                                "acknowledge_status": {
                                                    "type": "string",
                                                    "description": "pending、retry、done或not_applicable；订阅永远不consume。"
                                                },
                                                "trace_id": {
                                                    "type": "string",
                                                    "description": "支持后台定位异常的追踪号。"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "失败的稳定原因码，不能据此判断未扣款。"
                                                },
                                                "next_action": {
                                                    "type": "string",
                                                    "description": "Google下单：purchase表示继续原意向，restore表示查询INAPP/SUBS恢复待付或未消费购买，none表示原意向已付款且收尾完成或已关闭。失败时retry表示复用原凭证重试，contact_support表示核对归属或联系支持。"
                                                },
                                                "can_start_purchase": {
                                                    "type": "boolean",
                                                    "description": "Google下单成功时返回；false时不得发起BillingFlow。true也须先查询INAPP/SUBS恢复商店未完成购买，不能只凭本地尚无绑定判定Google未扣款。"
                                                },
                                                "subscription": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "Google订阅状态摘要，含status、expires_at、auto_renew_status、acknowledge_status、manage_url。"
                                                },
                                                "membership": {
                                                    "type": "object",
                                                    "nullable": true,
                                                    "description": "两平台统一会员计算结果；固定时长仅在无有效订阅时消耗。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Success",
                                    "data": {
                                        "order_no": "GP202610231430001234567890AB",
                                        "product_id": "coins_100",
                                        "obfuscated_account_id": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0",
                                        "status": 1,
                                        "coin_amount": 100,
                                        "member_days": 0,
                                        "delivery_status": "delivered",
                                        "consume_status": "done",
                                        "refund_status": "none",
                                        "paid_at": "2026-10-23 14:30:00"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "purchase_token"
                                ],
                                "properties": {
                                    "purchase_token": {
                                        "type": "string",
                                        "maxLength": 4096,
                                        "description": "BillingClient返回的purchaseToken，不得自行构造、打印或作为用户标识。"
                                    },
                                    "mode": {
                                        "type": "string",
                                        "enum": [
                                            "verify",
                                            "restore",
                                            "refresh"
                                        ],
                                        "default": "verify",
                                        "description": "verify默认新购验单；restore/refresh仅用于订阅，核验同账号归属后同步，不能换绑。"
                                    },
                                    "order_no": {
                                        "type": "string",
                                        "description": "mode=verify必填本站订单号；恢复订阅可不传。"
                                    },
                                    "product_id": {
                                        "type": "string",
                                        "description": "mode=verify必填Google商品ID；恢复时由官方核验。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/hot-search-words": {
            "get": {
                "tags": [
                    "公共模板"
                ],
                "summary": "获取热搜词",
                "description": "给首页或搜索页展示热搜词使用，只返回后台已启用的词条，并根据请求语言返回多语言文案；没有对应翻译时自动按默认语言回退。",
                "operationId": "app_mallapi_controller_HotSearchWordController_index",
                "x-module": {
                    "key": "public-template",
                    "name": "公共模板",
                    "description": "客户端公共基础数据和公共页面模板，包括可用语言、热搜词及关于我们等内容页。",
                    "order": 55
                },
                "parameters": [
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "lang",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "zh-CN",
                                "en",
                                "ja"
                            ]
                        },
                        "example": "zh-CN",
                        "description": "返回文案语言，可传 zh-CN、en 或 ja；也可以使用 language、locale 参数或 Accept-Language 请求头。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "array",
                                            "items": {
                                                "type": "object",
                                                "properties": {
                                                    "code": {
                                                        "type": "string",
                                                        "example": "trending"
                                                    },
                                                    "keyword": {
                                                        "type": "string",
                                                        "example": "热门推荐"
                                                    },
                                                    "lang": {
                                                        "type": "string",
                                                        "example": "zh-CN"
                                                    },
                                                    "sort": {
                                                        "type": "integer",
                                                        "example": 100
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": [
                                        {
                                            "code": "trending",
                                            "keyword": "热门推荐",
                                            "lang": "zh-CN",
                                            "sort": 100
                                        }
                                    ]
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/ios-pay/notifications": {
            "post": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "Apple 服务端通知 V2",
                "description": "Apple 异步通知专用；服务端重新向 Apple 查询交易，不需要用户登录。",
                "operationId": "app_mallapi_controller_IosPayController_notifications",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": false,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [],
                                "properties": {
                                    "signedPayload": {
                                        "type": "string",
                                        "example": "",
                                        "description": "Apple App Store Server Notifications V2 的通知 JWS。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/ios-pay/order": {
            "post": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "创建 iOS 内购订单",
                "description": "根据 Apple Product ID 生成订单及 appAccountToken，购买时须把 token 交给 StoreKit。自动续期订阅必须传 idempotency_key（购买请求标识），固定天数会员和 K 币可不传。每次新的主动购买由客户端生成并保存新 UUID；同一次购买的网络重试必须复用原标识，同一账号、同一标识返回原订单，不能换商品。示例 UUID 仅供展示，不要用于所有购买。订阅缺少标识或格式无效时返回 SUBSCRIPTION_INTENT_INVALID（购买请求标识无效）。",
                "operationId": "app_mallapi_controller_IosPayController_order",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "product_id"
                                ],
                                "properties": {
                                    "product_id": {
                                        "type": "string",
                                        "example": "com.mdss.ori.mdShow.vip.test.monthly",
                                        "description": "Apple 商品 ID，使用 iOS 商品列表返回的 product_id；示例为自动续期月订阅，请替换为实际商品 ID。"
                                    },
                                    "idempotency_key": {
                                        "type": "string",
                                        "minLength": 16,
                                        "maxLength": 128,
                                        "pattern": "^[A-Za-z0-9._:-]{16,128}$",
                                        "example": "d510b464-a37b-423e-bf6d-8775d150231a",
                                        "description": "购买请求标识：自动续期订阅必填，固定天数会员和 K 币可不传。长度 16–128 个字符，仅允许英文字母、数字和 . _ : -，推荐使用客户端生成并保存的 UUID。每次新的主动购买用新标识，同一次购买的网络重试复用原标识；同一账号、同一标识返回原订单，不能用于不同商品。示例 UUID 仅供展示，不要作为固定值复用。",
                                        "x-required-when": "自动续期订阅"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/ios-pay/order/{orderNo}": {
            "get": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "查询 iOS 内购订单",
                "description": "仅查询当前登录用户的 iOS 订单支付状态及撤销状态。",
                "operationId": "app_mallapi_controller_IosPayController_orderStatus",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [
                    {
                        "name": "orderNo",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "GP202610231430001234567890AB",
                        "description": "本站订单号，仅能查询当前登录用户的订单。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/ios-pay/products": {
            "get": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "iOS 内购商品列表",
                "description": "按后台排序值 sort 升序、相同时按模板 ID 升序返回 Apple Product ID 与当前充值模板权益；本地价格由 StoreKit 展示。",
                "operationId": "app_mallapi_controller_IosPayController_products",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/ios-pay/transaction/{transactionId}": {
            "get": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "查询并处理 Apple 异常交易",
                "description": "用于处理 StoreKit 异常交易队列。已有交易记录且找到当前账号原订单，但未支付、已关闭或已付款待发货时，自动核验 Apple，尝试恢复原订单付款并幂等补发；确认提交到账后才返回 can_finish=true、next_action=finish。真实交易冲突、核验或补发失败时 can_finish=false，记录异常日志，按 next_action 重试或人工核查，不覆盖另一笔付款。未记录交易或未找到关联订单时，仍按异常收尾规则返回 code=200、can_finish=true、next_action=finish 并记录异常日志；此时 order_no=null，state 为 not_recorded 或 order_missing，不代表权益已到账。recovery_attempted=true 表示本次触发了自动恢复，无论成功或失败均保存接口响应审计。正常已到账、缺关联订单和账号冲突分支仅查本地；自动恢复可能请求 Apple 并修改原订单和权益，App 不应轮询。App 仅可完成当前登录会话中本地验证通过且交易号精确一致的这一笔交易。",
                "operationId": "app_mallapi_controller_IosPayController_transactionStatus",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [
                    {
                        "name": "transactionId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2000001260300890",
                        "description": "Apple StoreKit 返回的 transaction.id，必须按字符串传递，1至30位数字；不是 originalTransactionId。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码：200已读取结果或恢复成功（仍须判断can_finish）、400参数或核验不符、401未登录、409账号/付款冲突或交易撤销、503查询/自动恢复失败或记录不一致。"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "transaction_id": {
                                                    "type": "string",
                                                    "description": "本次查询的具体Apple交易号。"
                                                },
                                                "recorded": {
                                                    "type": "boolean",
                                                    "description": "是否已有本地交易记录，不代表存在关联订单或权益已到账；冲突响应省略。"
                                                },
                                                "state": {
                                                    "type": "string",
                                                    "enum": [
                                                        "not_recorded",
                                                        "order_missing",
                                                        "delivered",
                                                        "delivery_pending",
                                                        "revoked",
                                                        "conflict",
                                                        "inconsistent",
                                                        "recovery_failed"
                                                    ]
                                                },
                                                "order_no": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "该交易的原订单号；禁止将旧交易改配最新订单。"
                                                },
                                                "product_id": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "original_transaction_id": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "environment": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "template_type": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "1会员、2K币；未记录时为null。"
                                                },
                                                "purchase_kind": {
                                                    "type": "string",
                                                    "nullable": true,
                                                    "description": "自动续期为auto_renewable；固定商品及未记录为null。"
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "nullable": true,
                                                    "description": "原订单状态：0待支付、1已支付、2已关闭；未记录时为null。"
                                                },
                                                "delivery_status": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "revoked": {
                                                    "type": "boolean",
                                                    "nullable": true,
                                                    "description": "本地已记录的撤销状态；未记录为null，不实时查询Apple。"
                                                },
                                                "can_finish": {
                                                    "type": "boolean",
                                                    "description": "已到账且记录一致时为true；异常队列中未记录或缺原单也为true，并记录异常日志，不代表权益已到账。App须核对当前会话及本地验证通过的具体交易号；缺原单时商品字段可能为null。"
                                                },
                                                "next_action": {
                                                    "type": "string",
                                                    "enum": [
                                                        "verify_original",
                                                        "restore",
                                                        "finish",
                                                        "contact_support",
                                                        "retry"
                                                    ],
                                                    "description": "retry：自动恢复暂未成功，保留同笔交易，退避后重试本接口；contact_support：核验或记录冲突，人工核查。"
                                                },
                                                "recovery_attempted": {
                                                    "type": "boolean",
                                                    "description": "仅触发自动恢复时返回true；已核验并补发提交成功才允许finish，失败时can_finish=false。"
                                                },
                                                "checked_at": {
                                                    "type": "integer",
                                                    "description": "本次读取订单结果的UTC秒时间；不是Apple交易签名时间。"
                                                },
                                                "trace_id": {
                                                    "type": "string"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "异常原因码；IOS_TRANSACTION_NOT_FOUND 表示未记录，IOS_TRANSACTION_ORDER_MISSING 表示缺原单，这两种异常仍允许finish并记录日志。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Success",
                                    "data": {
                                        "transaction_id": "2000001260300890",
                                        "recorded": true,
                                        "state": "delivered",
                                        "order_no": "IO20261102134050EXAMPLE",
                                        "product_id": "coins_100",
                                        "original_transaction_id": "2000001260300890",
                                        "environment": "Sandbox",
                                        "template_type": 2,
                                        "purchase_kind": null,
                                        "status": 1,
                                        "delivery_status": "delivered",
                                        "revoked": false,
                                        "can_finish": true,
                                        "next_action": "finish",
                                        "checked_at": 1793599200,
                                        "trace_id": "0123456789abcdef01234567"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/ios-pay/verify": {
            "post": {
                "tags": [
                    "iOS 内购模块"
                ],
                "summary": "Apple 内购交易验单",
                "description": "原生 App 购买成功后提交订单号及 Apple transactionId，由服务端向 Apple 查询并发放权益。",
                "operationId": "app_mallapi_controller_IosPayController_verify",
                "x-module": {
                    "key": "IosPayController",
                    "name": "iOS 内购模块",
                    "description": "StoreKit 商品、订单、Apple 验单和服务端通知。",
                    "order": 45
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": false,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [],
                                "properties": {
                                    "order_no": {
                                        "type": "string",
                                        "example": "GP202610231430001234567890AB",
                                        "description": "订单号。"
                                    },
                                    "transaction_id": {
                                        "type": "string",
                                        "example": "",
                                        "description": "Apple StoreKit 返回的 transaction.id。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/languages": {
            "get": {
                "tags": [
                    "公共模板"
                ],
                "summary": "获取可用语言",
                "description": "给客户端初始化语言选择器使用，返回后台启用的语言、语言名称、原生名称以及系统默认语言。",
                "operationId": "app_mallapi_controller_LanguageController_index",
                "x-module": {
                    "key": "public-template",
                    "name": "公共模板",
                    "description": "客户端公共基础数据和公共页面模板，包括可用语言、热搜词及关于我们等内容页。",
                    "order": 55
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "code": "en",
                                                "name": "English",
                                                "native_name": "English",
                                                "is_default": 1
                                            }
                                        ],
                                        "default": "en"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/pay/currencies": {
            "get": {
                "tags": [
                    "支付模块"
                ],
                "summary": "获取可支付币种",
                "description": "返回当前启用的 PayerMax 支付配置允许使用的币种和默认币种；创建订单前应先调用此接口。",
                "operationId": "app_mallapi_controller_PayController_currencies",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "multi_currency_enabled": true,
                                        "default_currency": "USD",
                                        "currencies": [
                                            {
                                                "code": "USD",
                                                "name": "US Dollar",
                                                "symbol": "$",
                                                "minor_unit": 2
                                            }
                                        ]
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/pay/episodeUnlock": {
            "post": {
                "tags": [
                    "支付模块"
                ],
                "summary": "K 币解锁单集",
                "description": "使用账户余额解锁指定付费剧集。",
                "operationId": "app_mallapi_controller_PayController_episodeUnlock",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "drama_id": 1,
                                        "episode_id": 1,
                                        "coin_amount": 10,
                                        "balance": 90,
                                        "unlock_time": "2026-08-07 14:30:00"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "episode_id"
                                ],
                                "properties": {
                                    "episode_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "剧集 ID。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/pay/order": {
            "post": {
                "tags": [
                    "支付模块"
                ],
                "summary": "创建支付订单",
                "description": "根据套餐、可选短剧、支付币种和支付渠道创建订单；PayerMax 成功时返回收银台跳转地址。",
                "operationId": "app_mallapi_controller_PayController_order",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "order_no": "MO20260807143000123456",
                                        "currency_code": "USD",
                                        "pay_amount": "9.99",
                                        "amount_minor": 999,
                                        "pay_channel": "payermax",
                                        "status": 0,
                                        "checkout_url": "https://checkout.payermax.com/example"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "template_id"
                                ],
                                "properties": {
                                    "template_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "充值套餐 ID。"
                                    },
                                    "drama_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "短剧 ID。"
                                    },
                                    "currency_code": {
                                        "type": "string",
                                        "example": "USD",
                                        "description": "支付币种代码，必须来自“获取可支付币种”接口；不传时使用默认币种。"
                                    },
                                    "language": {
                                        "type": "string",
                                        "example": "en",
                                        "description": "PayerMax 收银台显示语言，可传 zh、en、id、th、vi、ja 或 ko；不传时使用支付配置默认值。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/pay/order/{orderNo}": {
            "get": {
                "tags": [
                    "支付模块"
                ],
                "summary": "订单详情",
                "description": "按本站订单号查询当前用户的订单；保留支付结果查询字段，并返回商品、渠道、金额和时间，不返回平台支付凭据。",
                "operationId": "app_mallapi_controller_PayController_orderStatus",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [
                    {
                        "name": "orderNo",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "GP202610231430001234567890AB",
                        "description": "本站订单号，仅能查询当前登录用户的订单。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "order_no": {
                                                    "type": "string",
                                                    "description": "本站订单号。"
                                                },
                                                "template_type": {
                                                    "type": "integer",
                                                    "description": "1 会员、2 K 币、3 整剧买断。"
                                                },
                                                "template_name": {
                                                    "type": "string",
                                                    "description": "下单时的商品名称。"
                                                },
                                                "status": {
                                                    "type": "integer",
                                                    "description": "0 待支付、1 已支付、2 已关闭。"
                                                },
                                                "display_status": {
                                                    "type": "string",
                                                    "description": "页面状态：pending、closed、completed、delivery_pending、refund_review、revoked。"
                                                },
                                                "pay_amount": {
                                                    "type": "string",
                                                    "description": "订单记录的支付金额；结合 price_known 使用。"
                                                },
                                                "currency_code": {
                                                    "type": "string",
                                                    "description": "订单记录的币种。"
                                                },
                                                "price_known": {
                                                    "type": "boolean",
                                                    "description": "金额及币种是否可用于展示。"
                                                },
                                                "coin_amount": {
                                                    "type": "integer"
                                                },
                                                "member_days": {
                                                    "type": "integer"
                                                },
                                                "drama_id": {
                                                    "type": "integer"
                                                },
                                                "pay_channel": {
                                                    "type": "string"
                                                },
                                                "delivery_status": {
                                                    "type": "string"
                                                },
                                                "refund_status": {
                                                    "type": "string"
                                                },
                                                "created_at": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "paid_at": {
                                                    "type": "string",
                                                    "nullable": true
                                                },
                                                "expire_time": {
                                                    "type": "string",
                                                    "nullable": true
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "order_no": "MO20261028120000123456",
                                        "template_type": 2,
                                        "template_name": "320 K Coins",
                                        "status": 1,
                                        "display_status": "completed",
                                        "pay_amount": "2.99",
                                        "currency_code": "USD",
                                        "price_known": true,
                                        "coin_amount": 320,
                                        "member_days": 0,
                                        "drama_id": 0,
                                        "pay_channel": "payermax",
                                        "delivery_status": "",
                                        "refund_status": "",
                                        "created_at": "2026-10-28 12:00:00",
                                        "paid_at": "2026-10-28 12:01:00",
                                        "expire_time": null
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/pay/orders": {
            "get": {
                "tags": [
                    "支付模块"
                ],
                "summary": "购买记录",
                "description": "分页查询当前用户的全部、K 币或会员订单，按订单 ID 倒序。金额和币种来自订单快照；平台未提供价格时 price_known 为 false。",
                "operationId": "app_mallapi_controller_PayController_orders",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1,
                            "minimum": 1
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "minimum": 1,
                            "maximum": 50
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "all",
                                "coins",
                                "membership"
                            ],
                            "default": "all"
                        },
                        "example": "all",
                        "description": "订单类型筛选。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "list": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "order_no": {
                                                                "type": "string",
                                                                "description": "本站订单号。"
                                                            },
                                                            "template_type": {
                                                                "type": "integer",
                                                                "description": "1 会员、2 K 币、3 整剧买断。"
                                                            },
                                                            "template_name": {
                                                                "type": "string",
                                                                "description": "下单时的商品名称。"
                                                            },
                                                            "status": {
                                                                "type": "integer",
                                                                "description": "0 待支付、1 已支付、2 已关闭。"
                                                            },
                                                            "display_status": {
                                                                "type": "string",
                                                                "description": "页面状态：pending、closed、completed、delivery_pending、refund_review、revoked。"
                                                            },
                                                            "pay_amount": {
                                                                "type": "string",
                                                                "description": "订单记录的支付金额；结合 price_known 使用。"
                                                            },
                                                            "currency_code": {
                                                                "type": "string",
                                                                "description": "订单记录的币种。"
                                                            },
                                                            "price_known": {
                                                                "type": "boolean",
                                                                "description": "金额及币种是否可用于展示。"
                                                            },
                                                            "coin_amount": {
                                                                "type": "integer"
                                                            },
                                                            "member_days": {
                                                                "type": "integer"
                                                            },
                                                            "drama_id": {
                                                                "type": "integer"
                                                            },
                                                            "pay_channel": {
                                                                "type": "string"
                                                            },
                                                            "delivery_status": {
                                                                "type": "string"
                                                            },
                                                            "refund_status": {
                                                                "type": "string"
                                                            },
                                                            "created_at": {
                                                                "type": "string",
                                                                "nullable": true
                                                            },
                                                            "paid_at": {
                                                                "type": "string",
                                                                "nullable": true
                                                            },
                                                            "expire_time": {
                                                                "type": "string",
                                                                "nullable": true
                                                            }
                                                        }
                                                    }
                                                },
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "page": {
                                                    "type": "integer"
                                                },
                                                "limit": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "order_no": "MO20261028120000123456",
                                                "template_type": 2,
                                                "template_name": "320 K Coins",
                                                "status": 1,
                                                "display_status": "completed",
                                                "pay_amount": "2.99",
                                                "currency_code": "USD",
                                                "price_known": true,
                                                "coin_amount": 320,
                                                "member_days": 0,
                                                "drama_id": 0,
                                                "pay_channel": "payermax",
                                                "delivery_status": "",
                                                "refund_status": "",
                                                "created_at": "2026-10-28 12:00:00",
                                                "paid_at": "2026-10-28 12:01:00",
                                                "expire_time": null
                                            }
                                        ],
                                        "total": 1,
                                        "page": 1,
                                        "limit": 20
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/pay/payermax/notify": {
            "post": {
                "tags": [
                    "支付模块"
                ],
                "summary": "PayerMax 支付通知",
                "description": "仅供 PayerMax 服务端异步通知调用。请求体必须为网关原始 JSON，sign 请求头用于 RSA-SHA256 验签；客户端不得调用此接口。",
                "operationId": "app_mallapi_controller_PayController_payermaxNotify",
                "x-module": {
                    "key": "PayController",
                    "name": "支付模块",
                    "description": "支付币种、订单创建、网关回调和单集解锁。",
                    "order": 40
                },
                "parameters": [
                    {
                        "name": "sign",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "PayerMax 使用商户公钥对原始请求体进行 RSA-SHA256 验签的 Base64 签名。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "string",
                                            "example": "SUCCESS"
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "Success"
                                        }
                                    }
                                },
                                "example": {
                                    "code": "SUCCESS",
                                    "msg": "Success"
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "appId",
                                    "merchantNo",
                                    "code",
                                    "data"
                                ],
                                "properties": {
                                    "version": {
                                        "type": "string",
                                        "example": "1.5",
                                        "description": "PayerMax 通知协议版本。"
                                    },
                                    "keyVersion": {
                                        "type": "string",
                                        "example": "1",
                                        "description": "网关密钥版本。"
                                    },
                                    "requestTime": {
                                        "type": "string",
                                        "example": "2026-08-07T14:30:00.000+08:00",
                                        "description": "网关发送通知的时间。"
                                    },
                                    "appId": {
                                        "type": "string",
                                        "example": "payermax-app-id",
                                        "description": "PayerMax 应用 ID。"
                                    },
                                    "merchantNo": {
                                        "type": "string",
                                        "example": "payermax-merchant-no",
                                        "description": "PayerMax 商户号。"
                                    },
                                    "code": {
                                        "type": "string",
                                        "example": "APPLY_SUCCESS",
                                        "description": "网关受理状态，成功通知必须为 APPLY_SUCCESS。"
                                    },
                                    "data": {
                                        "type": "object",
                                        "description": "支付结果数据。",
                                        "required": [
                                            "outTradeNo",
                                            "status",
                                            "totalAmount",
                                            "currency",
                                            "tradeToken"
                                        ],
                                        "properties": {
                                            "outTradeNo": {
                                                "type": "string",
                                                "example": "MO20260807143000123456",
                                                "description": "本地订单号。"
                                            },
                                            "status": {
                                                "type": "string",
                                                "example": "SUCCESS",
                                                "description": "支付状态：SUCCESS、FAILED、CLOSED 或 PENDING。"
                                            },
                                            "totalAmount": {
                                                "type": "number",
                                                "example": 9.99,
                                                "description": "订单支付金额，必须与本地订单金额一致。"
                                            },
                                            "currency": {
                                                "type": "string",
                                                "example": "USD",
                                                "description": "三位 ISO 币种代码，必须与本地订单一致。"
                                            },
                                            "tradeToken": {
                                                "type": "string",
                                                "example": "payermax-trade-token",
                                                "description": "PayerMax 支付流水号。"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/playback/aes128/key": {
            "get": {
                "tags": [
                    "AES-128 加密播放模块"
                ],
                "x-module": {
                    "key": "Aes128PlaybackController",
                    "name": "AES-128 加密播放模块",
                    "description": "独立加密播放地址与播放器鉴权取密钥接口。",
                    "order": 22
                },
                "operationId": "app_mallapi_controller_Aes128PlaybackController_key",
                "summary": "AES-128 播放器取密钥",
                "description": "由加密清单EXT-X-KEY自动调用。video_id、CipherText、MtsHlsUriToken必须取自当前真实清单URI，参数不可重复或使用数组语法，Base64中的+/=须URL编码。每次重新校验会话、VideoId、可信清单密文摘要、账号及观看权益；KMS返回后再验权限。成功为HTTP200原始16字节，application/octet-stream，不是JSON/Base64。失败使用真实HTTP400/403/429/503及JSON reason_code。允许拖动和重试；不使用App登录Token。Redis故障拒绝，不缓存密钥。",
                "x-auth-note": "认证：使用清单中的短期播放令牌，不发送 App 登录令牌。",
                "parameters": [
                    {
                        "name": "video_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^[a-zA-Z0-9_-]{1,128}$"
                        },
                        "description": "实际云端VideoId，须与签发会话一致。"
                    },
                    {
                        "name": "CipherText",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "maxLength": 8192
                        },
                        "description": "当前清单中的标准Base64密文，须与后端校验过的密文摘要一致。填写解码后的参数值，页面发送时自动URL编码。"
                    },
                    {
                        "name": "MtsHlsUriToken",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string",
                            "pattern": "^[a-f0-9]{64}$"
                        },
                        "description": "CDN透传的短期播放令牌，须来自真实签发地址，不是playback_id。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "原始16字节AES-128密钥，禁止缓存或日志输出",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            }
                        },
                        "content": {
                            "application/octet-stream": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary",
                                    "minLength": 16,
                                    "maxLength": 16
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "参数格式错误",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "code",
                                        "msg",
                                        "data"
                                    ],
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "required": [
                                                "reason_code"
                                            ],
                                            "properties": {
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "明确错误环节的稳定原因码，不返回云端原文或密钥。"
                                                },
                                                "retry_after": {
                                                    "type": "integer",
                                                    "description": "限流时建议等待秒数。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 400,
                                    "msg": "参数格式错误",
                                    "data": {
                                        "reason_code": "AES128_KEY_INPUT_INVALID"
                                    }
                                }
                            }
                        }
                    },
                    "403": {
                        "description": "会话失效/过期、绑定不一致或观看权限撤销",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "code",
                                        "msg",
                                        "data"
                                    ],
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "required": [
                                                "reason_code"
                                            ],
                                            "properties": {
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "明确错误环节的稳定原因码，不返回云端原文或密钥。"
                                                },
                                                "retry_after": {
                                                    "type": "integer",
                                                    "description": "限流时建议等待秒数。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 403,
                                    "msg": "会话失效/过期、绑定不一致或观看权限撤销",
                                    "data": {
                                        "reason_code": "AES128_KEY_BINDING_INVALID"
                                    }
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "IP或播放会话请求超限，按Retry-After等待",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            },
                            "Retry-After": {
                                "schema": {
                                    "type": "integer",
                                    "minimum": 1
                                },
                                "description": "建议等待秒数"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "code",
                                        "msg",
                                        "data"
                                    ],
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "required": [
                                                "reason_code"
                                            ],
                                            "properties": {
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "明确错误环节的稳定原因码，不返回云端原文或密钥。"
                                                },
                                                "retry_after": {
                                                    "type": "integer",
                                                    "description": "限流时建议等待秒数。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 429,
                                    "msg": "IP或播放会话请求超限，按Retry-After等待",
                                    "data": {
                                        "reason_code": "AES128_RATE_LIMITED",
                                        "retry_after": 45
                                    }
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "播放开关关闭、配置、Redis或VOD/KMS故障",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "code",
                                        "msg",
                                        "data"
                                    ],
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "required": [
                                                "reason_code"
                                            ],
                                            "properties": {
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "明确错误环节的稳定原因码，不返回云端原文或密钥。"
                                                },
                                                "retry_after": {
                                                    "type": "integer",
                                                    "description": "限流时建议等待秒数。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 503,
                                    "msg": "播放开关关闭、配置、Redis或VOD/KMS故障",
                                    "data": {
                                        "reason_code": "AES128_SESSION_UNAVAILABLE"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/playback/aes128/url": {
            "get": {
                "tags": [
                    "AES-128 加密播放模块"
                ],
                "x-module": {
                    "key": "Aes128PlaybackController",
                    "name": "AES-128 加密播放模块",
                    "description": "独立加密播放地址与播放器鉴权取密钥接口。",
                    "order": 22
                },
                "operationId": "app_mallapi_controller_Aes128PlaybackController_url",
                "summary": "获取 AES-128 加密播放地址",
                "description": "独立于旧/mallapi/playback/url，仅返回已核验的HLSEncryption标准加密HLS。SD→云LD、HD→云SD、FD→云HD，默认SD。免费集可游客；付费集须会员、整剧或单集解锁，失效登录令牌不能降级游客。后端校验实际CDN清单及MtsHlsUriToken透传后保存短期Redis会话。把返回URL直接交给支持标准HLS AES-128的播放器，播放器自动取钥，无须App自行AES解密。按refresh_at提前刷新。HTTP始终200，读取JSON code：200成功、400参数、401登录、403无权、404下架/不存在、409缺档、429限流、503资源/配置/依赖故障；错误返回reason_code。CDN未透传为AES128_CDN_TOKEN_MISSING，无标准流为AES128_NO_COMPATIBLE_RESOURCE；不回退明文、MP4或私有加密。默认AES128_PLAYBACK_ENABLED=false，独立于转码开关。",
                "x-auth-note": "认证：免费集可不传 Authorization；付费集须登录并有观看权益，传失效令牌返回401。",
                "security": [
                    {},
                    {
                        "Authorization": []
                    }
                ],
                "parameters": [
                    {
                        "name": "episode_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647
                        },
                        "description": "业务剧集ID，不是VideoId。"
                    },
                    {
                        "name": "definition",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "SD",
                                "HD",
                                "FD"
                            ],
                            "default": "SD"
                        },
                        "example": "SD",
                        "description": "仅支持标准加密三档；请求缺档返回实际available_definitions。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Bearer <登录令牌>；免费集可不传，付费集必需。"
                    },
                    {
                        "name": "lang",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "zh-CN",
                                "en",
                                "ja"
                            ]
                        },
                        "description": "响应文案语言，也支持language、locale或Accept-Language。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "HTTP200，业务结果以JSON code为准；错误不含播放地址",
                        "headers": {
                            "Cache-Control": {
                                "description": "禁止缓存",
                                "schema": {
                                    "type": "string",
                                    "example": "private, no-store, max-age=0"
                                }
                            },
                            "Referrer-Policy": {
                                "schema": {
                                    "type": "string",
                                    "example": "no-referrer"
                                }
                            },
                            "Retry-After": {
                                "schema": {
                                    "type": "integer"
                                },
                                "description": "仅业务code=429时提供等待秒数"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "required": [
                                        "code",
                                        "msg",
                                        "data"
                                    ],
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "enum": [
                                                200,
                                                400,
                                                401,
                                                403,
                                                404,
                                                409,
                                                429,
                                                503
                                            ]
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "episode_id": {
                                                    "type": "integer"
                                                },
                                                "playback_id": {
                                                    "type": "string",
                                                    "description": "关联地址签发和取钥日志的安全摘要，不用于鉴权。"
                                                },
                                                "url": {
                                                    "type": "string",
                                                    "format": "uri",
                                                    "description": "保留CDN原签名并带MtsHlsUriToken的HTTPS地址，仅成功时返回，不记录到普通日志。"
                                                },
                                                "format": {
                                                    "type": "string",
                                                    "enum": [
                                                        "hls"
                                                    ]
                                                },
                                                "encryption": {
                                                    "type": "string",
                                                    "enum": [
                                                        "aes-128"
                                                    ]
                                                },
                                                "definition": {
                                                    "type": "string",
                                                    "enum": [
                                                        "SD",
                                                        "HD",
                                                        "FD"
                                                    ]
                                                },
                                                "available_definitions": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "string",
                                                        "enum": [
                                                            "SD",
                                                            "HD",
                                                            "FD"
                                                        ]
                                                    }
                                                },
                                                "width": {
                                                    "type": "integer"
                                                },
                                                "height": {
                                                    "type": "integer"
                                                },
                                                "fallback": {
                                                    "type": "boolean",
                                                    "enum": [
                                                        false
                                                    ]
                                                },
                                                "expires_at": {
                                                    "type": "integer",
                                                    "description": "Unix秒，已扣30秒安全余量，会话最长1800秒。"
                                                },
                                                "refresh_at": {
                                                    "type": "integer",
                                                    "description": "Unix秒；在此时刻前重新获取地址，切换播放器时保留播放位置。"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "明确错误环节的稳定原因码，不返回云端原文或密钥。"
                                                },
                                                "retry_after": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Success",
                                    "data": {
                                        "episode_id": 123,
                                        "playback_id": "987e765dcba0987654321abc",
                                        "url": "https://media.example.com/video/index.m3u8?auth_key=example&MtsHlsUriToken=example",
                                        "format": "hls",
                                        "encryption": "aes-128",
                                        "definition": "SD",
                                        "width": 478,
                                        "height": 848,
                                        "available_definitions": [
                                            "SD",
                                            "HD",
                                            "FD"
                                        ],
                                        "fallback": false,
                                        "expires_at": 1794801770,
                                        "refresh_at": 1794801710
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/playback/url": {
            "get": {
                "tags": [
                    "原生播放模块"
                ],
                "summary": "原生播放器播放链接",
                "description": "按episode_id验证观看权限，仅返回未加密的限时HLS。SD=标清、HD=高清、FD=超清，默认SD。响应文案默认英文，可通过lang、language、locale参数或Accept-Language请求头指定语言，参数优先于请求头。无可用HLS时返回503、明确错误信息及reason_code，不查询源文件，不返回MP4。有其他HLS但请求档缺失则code=409并返回available_definitions。加密及加密状态未知资源不返回。免费集允许游客，传入失效令牌返回401；付费集须登录且有观看权益。HTTP 200，业务状态读取code；所有响应no-store。地址到期需重新鉴权获取。",
                "operationId": "app_mallapi_controller_PlaybackController_url",
                "x-module": {
                    "key": "PlaybackController",
                    "name": "原生播放模块",
                    "description": "独立获取未加密 HLS 签名链接。",
                    "order": 21
                },
                "parameters": [
                    {
                        "name": "episode_id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 2147483647
                        },
                        "example": "",
                        "description": "业务剧集主键，不是阿里云VideoId。"
                    },
                    {
                        "name": "definition",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "SD",
                                "HD",
                                "FD"
                            ],
                            "default": "SD"
                        },
                        "example": "SD",
                        "description": "SD标清、HD高清、FD超清；仅支持这三档HLS，无资源时明确返回错误。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Bearer <token>。免费集可不传；付费集必须登录并有观看权益；传入无效令牌返回401。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "description": "业务码：200成功、400参数错误、401登录失效/缺失、403未解锁、404剧集不存在/下架、409指定清晰度不可用、429限流、503资源/服务暂不可用。"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "episode_id": {
                                                    "type": "integer"
                                                },
                                                "format": {
                                                    "type": "string",
                                                    "enum": [
                                                        "hls"
                                                    ]
                                                },
                                                "definition": {
                                                    "type": "string",
                                                    "enum": [
                                                        "SD",
                                                        "HD",
                                                        "FD"
                                                    ]
                                                },
                                                "url": {
                                                    "type": "string",
                                                    "description": "成功时才返回的HTTPS限时播放地址。"
                                                },
                                                "width": {
                                                    "type": "integer"
                                                },
                                                "height": {
                                                    "type": "integer"
                                                },
                                                "expires_at": {
                                                    "type": "integer",
                                                    "description": "UTC秒，已扣除30秒安全余量，客户端应提前刷新。"
                                                },
                                                "available_definitions": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "string",
                                                        "enum": [
                                                            "SD",
                                                            "HD",
                                                            "FD"
                                                        ]
                                                    }
                                                },
                                                "fallback": {
                                                    "type": "boolean",
                                                    "enum": [
                                                        false
                                                    ],
                                                    "description": "兼容保留字段，始终false；已取消MP4及源文件回退。"
                                                },
                                                "reason_code": {
                                                    "type": "string",
                                                    "description": "仅失败时提供稳定原因码，不包含云端原始错误。"
                                                },
                                                "retry_after": {
                                                    "type": "integer",
                                                    "description": "429时返回建议等待秒数。"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "episode_id": 123,
                                        "format": "hls",
                                        "definition": "SD",
                                        "url": "https://media.example.com/video/index.m3u8?auth_key=example",
                                        "width": 478,
                                        "height": 848,
                                        "expires_at": 1793772000,
                                        "available_definitions": [
                                            "SD",
                                            "HD",
                                            "FD"
                                        ],
                                        "fallback": false
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/recharge/template": {
            "get": {
                "tags": [
                    "充值模块"
                ],
                "summary": "充值套餐列表",
                "description": "获取可购买的会员、K 币或短剧买断套餐。",
                "operationId": "app_mallapi_controller_RechargeController_index",
                "x-module": {
                    "key": "RechargeController",
                    "name": "充值模块",
                    "description": "会员、K 币、买断等充值套餐。",
                    "order": 30
                },
                "parameters": [
                    {
                        "name": "currency_code",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "USD",
                        "description": "支付币种代码，必须来自“获取可支付币种”接口；不传时使用默认币种。"
                    },
                    {
                        "name": "drama_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "短剧 ID。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/recharge/template/{id}": {
            "get": {
                "tags": [
                    "充值模块"
                ],
                "summary": "充值套餐详情",
                "description": "获取单个充值套餐的价格、类型和权益说明。",
                "operationId": "app_mallapi_controller_RechargeController_show",
                "x-module": {
                    "key": "RechargeController",
                    "name": "充值模块",
                    "description": "会员、K 币、买断等充值套餐。",
                    "order": 30
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "资源 ID，路径中的通用主键。"
                    },
                    {
                        "name": "currency_code",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        },
                        "example": "USD",
                        "description": "支付币种代码，必须来自“获取可支付币种”接口；不传时使用默认币种。"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/access": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "我的权益",
                "description": "查询当前用户已解锁的剧集和整剧买断权益，或当前会员状态。已下架内容不出现在剧集列表；整剧买断每部剧显示一条，单集权益与买断去重。",
                "operationId": "app_mallapi_controller_UserController_access",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1,
                            "minimum": 1
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "minimum": 1,
                            "maximum": 50
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "type",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string",
                            "enum": [
                                "episodes",
                                "membership"
                            ],
                            "default": "episodes"
                        },
                        "example": "episodes",
                        "description": "权益页签。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer"
                                        },
                                        "msg": {
                                            "type": "string"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "list": {
                                                    "type": "array",
                                                    "items": {
                                                        "oneOf": [
                                                            {
                                                                "type": "object",
                                                                "properties": {
                                                                    "drama_id": {
                                                                        "type": "integer"
                                                                    },
                                                                    "episode_id": {
                                                                        "type": "integer"
                                                                    },
                                                                    "episode_no": {
                                                                        "type": "integer"
                                                                    },
                                                                    "title": {
                                                                        "type": "string"
                                                                    },
                                                                    "episode_title": {
                                                                        "type": "string"
                                                                    },
                                                                    "cover_url": {
                                                                        "type": "string"
                                                                    },
                                                                    "access_type": {
                                                                        "type": "string",
                                                                        "enum": [
                                                                            "episode",
                                                                            "drama"
                                                                        ]
                                                                    },
                                                                    "unlocked_at": {
                                                                        "type": "string",
                                                                        "nullable": true
                                                                    }
                                                                }
                                                            },
                                                            {
                                                                "type": "object",
                                                                "properties": {
                                                                    "is_active": {
                                                                        "type": "boolean"
                                                                    },
                                                                    "start_time": {
                                                                        "type": "string",
                                                                        "nullable": true
                                                                    },
                                                                    "end_time": {
                                                                        "type": "string",
                                                                        "nullable": true
                                                                    }
                                                                }
                                                            }
                                                        ]
                                                    }
                                                },
                                                "total": {
                                                    "type": "integer"
                                                },
                                                "page": {
                                                    "type": "integer"
                                                },
                                                "limit": {
                                                    "type": "integer"
                                                },
                                                "membership": {
                                                    "type": "object",
                                                    "properties": {
                                                        "is_active": {
                                                            "type": "boolean"
                                                        },
                                                        "start_time": {
                                                            "type": "string",
                                                            "nullable": true
                                                        },
                                                        "end_time": {
                                                            "type": "string",
                                                            "nullable": true
                                                        }
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "drama_id": 10,
                                                "episode_id": 123,
                                                "episode_no": 2,
                                                "title": "Sweet Us",
                                                "episode_title": "Episode 2",
                                                "cover_url": "https://example.com/cover.jpg",
                                                "access_type": "episode",
                                                "unlocked_at": "2026-10-28 12:00:00"
                                            }
                                        ],
                                        "total": 1,
                                        "page": 1,
                                        "limit": 20,
                                        "membership": {
                                            "is_active": true,
                                            "start_time": "2026-10-20 12:00:00",
                                            "end_time": "2026-11-20 12:00:00"
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/balanceLogs": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "K 币流水列表",
                "description": "分页查询当前登录用户的 K 币变动记录，按流水 ID 倒序排列。page 从 1 开始，limit 默认 20、最大 50；钱包页面每次请求 20 条，下滑至列表底部后请求下一页。",
                "operationId": "app_mallapi_controller_UserController_balanceLogs",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 1,
                            "minimum": 1
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "default": 20,
                            "minimum": 1,
                            "maximum": 50
                        },
                        "example": 20,
                        "description": "每页数量，默认 20，最多 50。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object",
                                            "properties": {
                                                "list": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "object",
                                                        "properties": {
                                                            "id": {
                                                                "type": "integer",
                                                                "description": "流水 ID"
                                                            },
                                                            "coin_change_amount": {
                                                                "type": "number",
                                                                "description": "K 币变动数量，支出为负数"
                                                            },
                                                            "balance_after": {
                                                                "type": "number",
                                                                "description": "变动后的 K 币余额"
                                                            },
                                                            "change_type": {
                                                                "type": "string",
                                                                "description": "变动类型，如 recharge、business_decrease、manual_increase"
                                                            },
                                                            "created_at": {
                                                                "type": "string",
                                                                "description": "流水创建时间"
                                                            }
                                                        }
                                                    }
                                                },
                                                "total": {
                                                    "type": "integer",
                                                    "description": "当前用户流水总数"
                                                },
                                                "page": {
                                                    "type": "integer",
                                                    "description": "当前页码"
                                                },
                                                "limit": {
                                                    "type": "integer",
                                                    "description": "实际每页数量"
                                                }
                                            }
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "id": 101,
                                                "coin_change_amount": -5,
                                                "balance_after": 95,
                                                "change_type": "business_decrease",
                                                "created_at": "2026-10-20 12:00:00"
                                            }
                                        ],
                                        "total": 1,
                                        "page": 1,
                                        "limit": 20
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/blocked-users": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "已屏蔽用户列表",
                "description": "分页获取当前登录用户的已屏蔽用户。屏蔽关系仅影响当前用户可见的评论和回复。",
                "operationId": "app_mallapi_controller_UserController_blockedUsers",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "user_id": 28,
                                                "nickname": "用户A",
                                                "avatar": "https://example.com/avatar.png",
                                                "blocked_at": "2026-09-29 12:00:00"
                                            }
                                        ],
                                        "total": 1,
                                        "page": 1,
                                        "limit": 20
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/blocked-users/batch-unblock": {
            "post": {
                "tags": [
                    "评论管理"
                ],
                "summary": "批量解除屏蔽用户",
                "description": "根据 user_ids 批量解除当前用户的屏蔽关系。不存在的关系会被忽略，单次最多 100 个用户。",
                "operationId": "app_mallapi_controller_UserController_batchUnblockUsers",
                "x-module": {
                    "key": "comment-management",
                    "name": "评论管理",
                    "description": "评论举报、用户屏蔽及其类型配置。",
                    "order": 25
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "user_ids"
                                ],
                                "properties": {
                                    "user_ids": {
                                        "type": "string",
                                        "example": "",
                                        "description": "待批量解除屏蔽的用户 ID 数组，单次最多 100 个。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/blocked-users/check/{userId}": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "查询用户屏蔽状态",
                "description": "查询当前登录用户是否已屏蔽指定用户。",
                "operationId": "app_mallapi_controller_UserController_checkBlockedUser",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "userId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 2,
                        "description": "用户 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "user_id": 28,
                                        "is_blocked": 1
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/blocked-users/{userId}": {
            "post": {
                "tags": [
                    "评论管理"
                ],
                "summary": "屏蔽用户",
                "description": "屏蔽指定用户。不能屏蔽自己；重复提交按已屏蔽成功返回。屏蔽后评论列表、回复列表和评论统计会立即过滤该用户内容。",
                "operationId": "app_mallapi_controller_UserController_blockUser",
                "x-module": {
                    "key": "comment-management",
                    "name": "评论管理",
                    "description": "评论举报、用户屏蔽及其类型配置。",
                    "order": 25
                },
                "parameters": [
                    {
                        "name": "userId",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 2,
                        "description": "用户 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "屏蔽成功",
                                    "data": {
                                        "user_id": 28,
                                        "is_blocked": 1,
                                        "blocked_at": "2026-09-29 12:00:00"
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/cancel": {
            "delete": {
                "tags": [
                    "用户模块"
                ],
                "summary": "注销账号",
                "description": "注销当前登录账号并使其所有登录令牌失效。仅写入用户软删除时间，订单、余额、解锁记录和审计数据会保留。",
                "operationId": "app_mallapi_controller_UserController_cancel",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/captcha": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "获取验证码滑块挑战",
                "description": "生成一次性拼图滑块挑战。scene 支持 register、login、password_reset；挑战与场景、账号、类型和请求 IP 绑定，有效期 3 分钟。",
                "operationId": "app_mallapi_controller_UserController_createSliderCaptcha",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "scene",
                                    "type",
                                    "username"
                                ],
                                "properties": {
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "account": {
                                        "type": "string",
                                        "example": "",
                                        "description": "接收验证码的手机号或邮箱。"
                                    },
                                    "scene": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块使用场景：register 注册、login 验证码登录、password_reset 找回密码。"
                                    },
                                    "type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "验证码类型：phone 或 email。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/captcha/verify": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "校验验证码滑块",
                "description": "提交滑块挑战 ID、原场景、账号类型、账号和拼图块横坐标。校验成功返回有效期 2 分钟的一次性 captcha_token。",
                "operationId": "app_mallapi_controller_UserController_verifySliderCaptcha",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "captcha_id",
                                    "scene",
                                    "type",
                                    "username",
                                    "x"
                                ],
                                "properties": {
                                    "captcha_id": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块挑战 ID，由获取注册滑块挑战接口返回。"
                                    },
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "account": {
                                        "type": "string",
                                        "example": "",
                                        "description": "接收验证码的手机号或邮箱。"
                                    },
                                    "x": {
                                        "type": "string",
                                        "example": "",
                                        "description": "拼图块最终横坐标，单位为原始挑战图片像素。"
                                    },
                                    "scene": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块使用场景：register 注册、login 验证码登录、password_reset 找回密码。"
                                    },
                                    "type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "验证码类型：phone 或 email。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/info": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "获取用户信息",
                "description": "获取当前登录用户资料、余额和会员状态。",
                "operationId": "app_mallapi_controller_UserController_info",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/login": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "用户登录",
                "description": "默认账号密码登录；login_type=phone_code 为手机号验证码登录；login_type=email_code 为邮箱验证码登录。账号统一使用 username 字段。",
                "operationId": "app_mallapi_controller_UserController_login",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "username",
                                    "password"
                                ],
                                "properties": {
                                    "login_type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "登录方式：password 默认账号密码，phone_code 手机号验证码，email_code 邮箱验证码。"
                                    },
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "code": {
                                        "type": "string",
                                        "example": "",
                                        "description": "短信或邮箱验证码。"
                                    },
                                    "password": {
                                        "type": "string",
                                        "example": "123456",
                                        "description": "密码。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/logout": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "退出登录",
                "description": "退出当前登录态，客户端应同步清理本地 token。",
                "operationId": "app_mallapi_controller_UserController_logout",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/password/reset": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "重置密码",
                "description": "校验找回密码验证码后设置新密码。password 与 password_confirmation 必须一致；验证码使用成功后立即失效，重置前签发的登录 Token 也会全部失效。",
                "operationId": "app_mallapi_controller_UserController_resetPassword",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Password reset successfully",
                                    "data": null
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "username",
                                    "type",
                                    "code",
                                    "password",
                                    "password_confirmation"
                                ],
                                "properties": {
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "验证码类型：phone 或 email。"
                                    },
                                    "code": {
                                        "type": "string",
                                        "example": "",
                                        "description": "短信或邮箱验证码。"
                                    },
                                    "password": {
                                        "type": "string",
                                        "example": "123456",
                                        "description": "密码。"
                                    },
                                    "password_confirmation": {
                                        "type": "string",
                                        "example": "123456",
                                        "description": "确认密码，必须与 password 完全一致。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/password/reset-code": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "发送找回密码验证码",
                "description": "向已注册账号发送找回密码验证码。captcha_token 当前为旧版 App 兼容可选参数；传入时会严格校验并一次性消费。设置 VERIFICATION_SLIDER_REQUIRED=true 后将强制要求先完成 scene=password_reset 的滑块校验。验证码与登录、注册场景隔离，有效期默认 5 分钟。",
                "operationId": "app_mallapi_controller_UserController_sendPasswordResetCode",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "Verification code sent",
                                    "data": {
                                        "expire_seconds": 300
                                    }
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "username",
                                    "type"
                                ],
                                "properties": {
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "account": {
                                        "type": "string",
                                        "example": "",
                                        "description": "接收验证码的手机号或邮箱。"
                                    },
                                    "type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "验证码类型：phone 或 email。"
                                    },
                                    "captcha_token": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块校验成功后返回的一次性凭证，与场景、账号类型、账号和请求 IP 绑定。兼容模式下可不传；一旦传入就必须有效。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/register": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "用户注册",
                "description": "创建用户账号，成功后返回 token 和用户信息。",
                "operationId": "app_mallapi_controller_UserController_register",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "username",
                                    "password",
                                    "code"
                                ],
                                "properties": {
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "password": {
                                        "type": "string",
                                        "example": "123456",
                                        "description": "密码。"
                                    },
                                    "code": {
                                        "type": "string",
                                        "example": "",
                                        "description": "短信或邮箱验证码。"
                                    },
                                    "nickname": {
                                        "type": "string",
                                        "example": "测试用户",
                                        "description": "用户昵称。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/saved-moments": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "已保存的观看时刻",
                "description": "分页获取当前登录用户保存的观看时间点。可按 episode_id 筛选，按保存时间倒序返回。",
                "operationId": "app_mallapi_controller_UserController_savedMoments",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "episode_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "剧集 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "list": [
                                            {
                                                "id": 1,
                                                "drama_id": 10,
                                                "episode_id": 123,
                                                "position_ms": 90000,
                                                "title": "Drama",
                                                "episode_no": 3,
                                                "cover_url": "https://example.com/cover.jpg",
                                                "created_at": "2026-10-27 12:00:00"
                                            }
                                        ],
                                        "total": 1,
                                        "page": 1,
                                        "limit": 20
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            },
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "保存观看时刻",
                "description": "按当前登录账号保存剧集播放位置。服务端向下取整到秒；同一账号、剧集、秒数重复提交返回原记录且 added=false。剧集和短剧必须已上架。",
                "operationId": "app_mallapi_controller_UserController_saveSavedMoment",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {
                                        "item": {
                                            "id": 1,
                                            "drama_id": 10,
                                            "episode_id": 123,
                                            "position_ms": 90000,
                                            "title": "Drama",
                                            "episode_no": 3,
                                            "cover_url": "https://example.com/cover.jpg",
                                            "created_at": "2026-10-27 12:00:00"
                                        },
                                        "added": true
                                    }
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "episode_id",
                                    "position_ms"
                                ],
                                "properties": {
                                    "episode_id": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "example": 123,
                                        "description": "已上架剧集 ID。"
                                    },
                                    "position_ms": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 86400000,
                                        "example": 90500,
                                        "description": "播放位置，毫秒；保存为 90000 毫秒。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/saved-moments/{id}": {
            "delete": {
                "tags": [
                    "用户模块"
                ],
                "summary": "删除观看时刻",
                "description": "按记录 ID 删除当前登录用户的观看时刻；重复删除也返回成功。",
                "operationId": "app_mallapi_controller_UserController_deleteSavedMoment",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "资源 ID，路径中的通用主键。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": null
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/sendLoginCode": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "发送登录验证码",
                "description": "发送手机号或邮箱登录验证码。captcha_token 当前为旧版 App 兼容可选参数；传入时会严格校验并一次性消费。设置 VERIFICATION_SLIDER_REQUIRED=true 后将强制要求先完成 scene=login 的滑块校验。type=phone 走阿里云短信，type=email 走 SMTP 邮箱。",
                "operationId": "app_mallapi_controller_UserController_sendLoginCode",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "type",
                                    "username"
                                ],
                                "properties": {
                                    "type": {
                                        "type": "string",
                                        "example": "",
                                        "description": "验证码类型：phone 或 email。"
                                    },
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "account": {
                                        "type": "string",
                                        "example": "",
                                        "description": "接收验证码的手机号或邮箱。"
                                    },
                                    "captcha_token": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块校验成功后返回的一次性凭证，与场景、账号类型、账号和请求 IP 绑定。兼容模式下可不传；一旦传入就必须有效。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/sendRegisterCode": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "发送注册验证码",
                "description": "向未注册邮箱发送注册验证码。captcha_token 当前为旧版 App 兼容可选参数；传入时会严格校验并一次性消费。设置 VERIFICATION_SLIDER_REQUIRED=true 后将强制要求先完成 scene=register 的滑块校验。",
                "operationId": "app_mallapi_controller_UserController_sendRegisterCode",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "username"
                                ],
                                "properties": {
                                    "username": {
                                        "type": "string",
                                        "example": "13800138000",
                                        "description": "统一账号字段，可以是手机号或邮箱。"
                                    },
                                    "email": {
                                        "type": "string",
                                        "example": "",
                                        "description": "参数说明待补充。"
                                    },
                                    "captcha_token": {
                                        "type": "string",
                                        "example": "",
                                        "description": "滑块校验成功后返回的一次性凭证，与场景、账号类型、账号和请求 IP 绑定。兼容模式下可不传；一旦传入就必须有效。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/update": {
            "put": {
                "tags": [
                    "用户模块"
                ],
                "summary": "更新用户资料",
                "description": "修改昵称、头像或密码等用户资料。",
                "operationId": "app_mallapi_controller_UserController_update",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": false,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [],
                                "properties": {
                                    "nickname": {
                                        "type": "string",
                                        "example": "测试用户",
                                        "description": "用户昵称。"
                                    },
                                    "avatar": {
                                        "type": "string",
                                        "example": "https://example.com/avatar.png",
                                        "description": "头像 URL。"
                                    },
                                    "password": {
                                        "type": "string",
                                        "example": "123456",
                                        "description": "密码。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/uploadAvatar": {
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "上传头像",
                "description": "上传用户头像文件，返回头像访问地址。",
                "operationId": "app_mallapi_controller_UserController_uploadAvatar",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "image"
                                ],
                                "properties": {
                                    "image": {
                                        "type": "string",
                                        "format": "binary",
                                        "description": "头像图片文件；服务端也兼容 file 字段。"
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mallapi/user/watchHistory": {
            "get": {
                "tags": [
                    "用户模块"
                ],
                "summary": "观看记录列表",
                "description": "分页查询当前用户的短剧观看记录。",
                "operationId": "app_mallapi_controller_UserController_watchHistory",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "页码，从 1 开始。"
                    },
                    {
                        "name": "limit",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 10,
                        "description": "每页数量。"
                    },
                    {
                        "name": "drama_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer"
                        },
                        "example": "",
                        "description": "短剧 ID。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            },
            "post": {
                "tags": [
                    "用户模块"
                ],
                "summary": "保存观看进度",
                "description": "保存当前短剧、剧集、播放秒数和进度百分比，用于下次续播。",
                "operationId": "app_mallapi_controller_UserController_saveWatchHistory",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "drama_id",
                                    "episode_id"
                                ],
                                "properties": {
                                    "drama_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "短剧 ID。"
                                    },
                                    "episode_id": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "剧集 ID。"
                                    },
                                    "watch_seconds": {
                                        "type": "integer",
                                        "example": "",
                                        "description": "当前播放到的秒数。"
                                    },
                                    "progress": {
                                        "type": "number",
                                        "example": "",
                                        "description": "播放进度百分比，0 到 100。"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "tags": [
                    "用户模块"
                ],
                "summary": "清空观看记录",
                "description": "清空当前用户全部观看历史。",
                "operationId": "app_mallapi_controller_UserController_clearWatchHistory",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        },
        "/mallapi/user/watchHistory/{id}": {
            "delete": {
                "tags": [
                    "用户模块"
                ],
                "summary": "删除单条观看记录",
                "description": "根据观看记录 ID 删除一条观看历史。",
                "operationId": "app_mallapi_controller_UserController_deleteWatchHistory",
                "x-module": {
                    "key": "UserController",
                    "name": "用户模块",
                    "description": "注册登录、用户资料、观看历史。",
                    "order": 10
                },
                "parameters": [
                    {
                        "name": "id",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "integer"
                        },
                        "example": 1,
                        "description": "资源 ID，路径中的通用主键。"
                    },
                    {
                        "name": "Authorization",
                        "in": "header",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "登录或注册接口返回的 token"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "业务响应",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "code": {
                                            "type": "integer",
                                            "example": 200
                                        },
                                        "msg": {
                                            "type": "string",
                                            "example": "success"
                                        },
                                        "data": {
                                            "type": "object"
                                        }
                                    }
                                },
                                "example": {
                                    "code": 200,
                                    "msg": "success",
                                    "data": {}
                                }
                            }
                        }
                    }
                },
                "security": [
                    {
                        "Authorization": []
                    }
                ]
            }
        }
    }
}