components: schemas: ErrorResponse: properties: code: description: 错误码 type: integer message: description: 错误消息 type: string timestamp: description: 时间戳 format: date-time type: string required: - code - message - timestamp type: object ModelAccountPageResult: properties: items: description: 账号列表 items: $ref: '#/components/schemas/ModelAccountResponse' nullable: true type: array page: description: 当前页码 type: integer size: description: 每页数量 type: integer total: description: 总记录数 type: integer type: object ModelAccountResponse: properties: created_at: description: 创建时间 type: string creator: description: 创建人ID minimum: 0 type: integer enterprise_id: description: 关联企业ID minimum: 0 nullable: true type: integer id: description: 账号ID minimum: 0 type: integer phone: description: 手机号 type: string shop_id: description: 关联店铺ID minimum: 0 nullable: true type: integer status: description: 状态 type: integer updated_at: description: 更新时间 type: string updater: description: 更新人ID minimum: 0 type: integer user_type: description: 用户类型 type: integer username: description: 用户名 type: string type: object ModelAssignPermissionsParams: properties: perm_ids: description: 权限ID列表 items: minimum: 0 type: integer minItems: 1 nullable: true type: array required: - perm_ids type: object ModelAssignRolesParams: properties: role_ids: description: 角色ID列表，传空数组可清空所有角色 items: minimum: 0 type: integer nullable: true type: array type: object ModelChangePasswordRequest: properties: new_password: type: string old_password: type: string type: object ModelCreateAccountRequest: properties: enterprise_id: description: 关联企业ID（企业账号必填） minimum: 0 nullable: true type: integer password: description: 密码 maxLength: 32 minLength: 8 type: string phone: description: 手机号 maxLength: 11 minLength: 11 type: string shop_id: description: 关联店铺ID（代理账号必填） minimum: 0 nullable: true type: integer user_type: description: 用户类型 (1:SuperAdmin, 2:Platform, 3:Agent, 4:Enterprise) maximum: 4 minimum: 1 type: integer username: description: 用户名 maxLength: 50 minLength: 3 type: string required: - username - phone - password - user_type type: object ModelCreatePermissionRequest: properties: parent_id: description: 父权限ID minimum: 0 nullable: true type: integer perm_code: description: 权限编码 maxLength: 100 minLength: 1 type: string perm_name: description: 权限名称 maxLength: 50 minLength: 1 type: string perm_type: description: 权限类型 (1:菜单, 2:按钮) maximum: 2 minimum: 1 type: integer platform: description: 适用端口 (all:全部, web:Web后台, h5:H5端)，默认为 all type: string sort: description: 排序值 minimum: 0 type: integer url: description: 请求路径 maxLength: 255 type: string required: - perm_name - perm_code - perm_type type: object ModelCreateRoleRequest: properties: role_desc: description: 角色描述 maxLength: 255 type: string role_name: description: 角色名称 maxLength: 50 minLength: 1 type: string role_type: description: 角色类型 (1:平台角色, 2:客户角色) maximum: 2 minimum: 1 type: integer required: - role_name - role_type type: object ModelLoginRequest: properties: device: type: string password: type: string username: type: string type: object ModelLoginResponse: properties: access_token: type: string expires_in: type: integer permissions: items: type: string nullable: true type: array refresh_token: type: string user: $ref: '#/components/schemas/ModelUserInfo' type: object ModelPermission: properties: available_for_role_types: type: string creator: minimum: 0 type: integer parent_id: minimum: 0 nullable: true type: integer perm_code: type: string perm_name: type: string perm_type: type: integer platform: type: string sort: type: integer status: type: integer updater: minimum: 0 type: integer url: type: string type: object ModelPermissionPageResult: properties: items: description: 权限列表 items: $ref: '#/components/schemas/ModelPermissionResponse' nullable: true type: array page: description: 当前页码 type: integer size: description: 每页数量 type: integer total: description: 总记录数 type: integer type: object ModelPermissionResponse: properties: available_for_role_types: description: 可用角色类型 type: string created_at: description: 创建时间 type: string creator: description: 创建人ID minimum: 0 type: integer id: description: 权限ID minimum: 0 type: integer parent_id: description: 父权限ID minimum: 0 nullable: true type: integer perm_code: description: 权限编码 type: string perm_name: description: 权限名称 type: string perm_type: description: 权限类型 type: integer platform: description: 适用端口 type: string sort: description: 排序值 type: integer status: description: 状态 type: integer updated_at: description: 更新时间 type: string updater: description: 更新人ID minimum: 0 type: integer url: description: 请求路径 type: string type: object ModelPermissionTreeNode: properties: available_for_role_types: description: 可用角色类型 type: string children: description: 子权限列表 items: $ref: '#/components/schemas/ModelPermissionTreeNode' type: array id: description: 权限ID minimum: 0 type: integer perm_code: description: 权限编码 type: string perm_name: description: 权限名称 type: string perm_type: description: 权限类型 type: integer platform: description: 适用端口 type: string sort: description: 排序值 type: integer url: description: 请求路径 type: string type: object ModelRefreshTokenRequest: properties: refresh_token: type: string type: object ModelRefreshTokenResponse: properties: access_token: type: string expires_in: type: integer type: object ModelRole: properties: creator: minimum: 0 type: integer role_desc: type: string role_name: type: string role_type: type: integer status: type: integer updater: minimum: 0 type: integer type: object ModelRolePageResult: properties: items: description: 角色列表 items: $ref: '#/components/schemas/ModelRoleResponse' nullable: true type: array page: description: 当前页码 type: integer size: description: 每页数量 type: integer total: description: 总记录数 type: integer type: object ModelRoleResponse: properties: created_at: description: 创建时间 type: string creator: description: 创建人ID minimum: 0 type: integer id: description: 角色ID minimum: 0 type: integer role_desc: description: 角色描述 type: string role_name: description: 角色名称 type: string role_type: description: 角色类型 type: integer status: description: 状态 type: integer updated_at: description: 更新时间 type: string updater: description: 更新人ID minimum: 0 type: integer type: object ModelUpdateAccountParams: properties: password: description: 密码 maxLength: 32 minLength: 8 nullable: true type: string phone: description: 手机号 maxLength: 11 minLength: 11 nullable: true type: string status: description: 状态 (0:禁用, 1:启用) maximum: 1 minimum: 0 nullable: true type: integer username: description: 用户名 maxLength: 50 minLength: 3 nullable: true type: string type: object ModelUpdatePasswordParams: properties: new_password: description: 新密码（8-32位） maxLength: 32 minLength: 8 type: string required: - new_password type: object ModelUpdatePermissionParams: properties: parent_id: description: 父权限ID minimum: 0 nullable: true type: integer perm_code: description: 权限编码 maxLength: 100 minLength: 1 nullable: true type: string perm_name: description: 权限名称 maxLength: 50 minLength: 1 nullable: true type: string platform: description: 适用端口 (all:全部, web:Web后台, h5:H5端) nullable: true type: string sort: description: 排序值 minimum: 0 nullable: true type: integer status: description: 状态 (0:禁用, 1:启用) maximum: 1 minimum: 0 nullable: true type: integer url: description: 请求路径 maxLength: 255 nullable: true type: string type: object ModelUpdateRoleParams: properties: role_desc: description: 角色描述 maxLength: 255 nullable: true type: string role_name: description: 角色名称 maxLength: 50 minLength: 1 nullable: true type: string status: description: 状态 (0:禁用, 1:启用) maximum: 1 minimum: 0 nullable: true type: integer type: object ModelUpdateRoleStatusParams: properties: status: description: 状态 (0:禁用, 1:启用) maximum: 1 minimum: 0 type: integer required: - status type: object ModelUpdateStatusParams: properties: status: description: 状态（0:禁用，1:启用） maximum: 1 minimum: 0 type: integer required: - status type: object ModelUserInfo: properties: enterprise_id: minimum: 0 type: integer enterprise_name: type: string id: minimum: 0 type: integer phone: type: string shop_id: minimum: 0 type: integer shop_name: type: string user_type: type: integer user_type_name: type: string username: type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT scheme: bearer type: http info: title: Admin API version: "1.0" openapi: 3.0.3 paths: /api/admin/accounts: get: parameters: - description: 页码 in: query name: page schema: description: 页码 minimum: 1 type: integer - description: 每页数量 in: query name: page_size schema: description: 每页数量 maximum: 100 minimum: 1 type: integer - description: 用户名模糊查询 in: query name: username schema: description: 用户名模糊查询 maxLength: 50 type: string - description: 手机号模糊查询 in: query name: phone schema: description: 手机号模糊查询 maxLength: 20 type: string - description: 用户类型 in: query name: user_type schema: description: 用户类型 maximum: 4 minimum: 1 nullable: true type: integer - description: 状态 in: query name: status schema: description: 状态 maximum: 1 minimum: 0 nullable: true type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountPageResult' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 账号列表 tags: - 账号相关 post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelCreateAccountRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 创建账号 tags: - 账号相关 /api/admin/accounts/{account_id}/roles/{role_id}: delete: parameters: - description: 账号ID in: path name: account_id required: true schema: description: 账号ID minimum: 0 type: integer - description: 角色ID in: path name: role_id required: true schema: description: 角色ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 移除角色 tags: - 账号相关 /api/admin/accounts/{id}: delete: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 删除账号 tags: - 账号相关 get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取账号详情 tags: - 账号相关 put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdateAccountParams' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 更新账号 tags: - 账号相关 /api/admin/accounts/{id}/roles: get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: items: $ref: '#/components/schemas/ModelRole' type: array description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取账号角色 tags: - 账号相关 post: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelAssignRolesParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 summary: 分配角色 tags: - 账号相关 /api/admin/login: post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelLoginRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelLoginResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 summary: 后台登录 tags: - 认证 /api/admin/logout: post: responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 登出 tags: - 认证 /api/admin/me: get: responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelUserInfo' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取当前用户信息 tags: - 认证 /api/admin/password: put: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelChangePasswordRequest' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 修改密码 tags: - 认证 /api/admin/permissions: get: parameters: - description: 页码 in: query name: page schema: description: 页码 minimum: 1 type: integer - description: 每页数量 in: query name: page_size schema: description: 每页数量 maximum: 100 minimum: 1 type: integer - description: 权限名称模糊查询 in: query name: perm_name schema: description: 权限名称模糊查询 maxLength: 50 type: string - description: 权限编码模糊查询 in: query name: perm_code schema: description: 权限编码模糊查询 maxLength: 100 type: string - description: 权限类型 in: query name: perm_type schema: description: 权限类型 maximum: 2 minimum: 1 nullable: true type: integer - description: 适用端口 in: query name: platform schema: description: 适用端口 type: string - description: 可用角色类型 (1:平台角色, 2:客户角色) in: query name: available_for_role_type schema: description: 可用角色类型 (1:平台角色, 2:客户角色) maximum: 2 minimum: 1 nullable: true type: integer - description: 父权限ID in: query name: parent_id schema: description: 父权限ID minimum: 0 nullable: true type: integer - description: 状态 in: query name: status schema: description: 状态 maximum: 1 minimum: 0 nullable: true type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelPermissionPageResult' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 权限列表 tags: - 权限 post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelCreatePermissionRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelPermissionResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 创建权限 tags: - 权限 /api/admin/permissions/{id}: delete: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 删除权限 tags: - 权限 get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelPermissionResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取权限详情 tags: - 权限 put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdatePermissionParams' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelPermissionResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 更新权限 tags: - 权限 /api/admin/permissions/tree: get: responses: "200": content: application/json: schema: items: $ref: '#/components/schemas/ModelPermissionTreeNode' type: array description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取权限树 tags: - 权限 /api/admin/platform-accounts: get: parameters: - description: 页码 in: query name: page schema: description: 页码 minimum: 1 type: integer - description: 每页数量 in: query name: page_size schema: description: 每页数量 maximum: 100 minimum: 1 type: integer - description: 用户名模糊查询 in: query name: username schema: description: 用户名模糊查询 maxLength: 50 type: string - description: 手机号模糊查询 in: query name: phone schema: description: 手机号模糊查询 maxLength: 20 type: string - description: 状态 in: query name: status schema: description: 状态 maximum: 1 minimum: 0 nullable: true type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountPageResult' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 平台账号列表 tags: - 平台账号 post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelCreateAccountRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 新增平台账号 tags: - 平台账号 /api/admin/platform-accounts/{account_id}/roles/{role_id}: delete: parameters: - description: 账号ID in: path name: account_id required: true schema: description: 账号ID minimum: 0 type: integer - description: 角色ID in: path name: role_id required: true schema: description: 角色ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 移除角色 tags: - 平台账号 /api/admin/platform-accounts/{id}: delete: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 删除平台账号 tags: - 平台账号 get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取平台账号详情 tags: - 平台账号 put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdateAccountParams' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelAccountResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 编辑平台账号 tags: - 平台账号 /api/admin/platform-accounts/{id}/password: put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdatePasswordParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 修改密码 tags: - 平台账号 /api/admin/platform-accounts/{id}/roles: get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: items: $ref: '#/components/schemas/ModelRole' type: array description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取账号角色 tags: - 平台账号 post: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelAssignRolesParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 分配角色 tags: - 平台账号 /api/admin/platform-accounts/{id}/status: put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdateStatusParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 启用/禁用账号 tags: - 平台账号 /api/admin/refresh-token: post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelRefreshTokenRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelRefreshTokenResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 summary: 刷新 Token tags: - 认证 /api/admin/roles: get: parameters: - description: 页码 in: query name: page schema: description: 页码 minimum: 1 type: integer - description: 每页数量 in: query name: page_size schema: description: 每页数量 maximum: 100 minimum: 1 type: integer - description: 角色名称模糊查询 in: query name: role_name schema: description: 角色名称模糊查询 maxLength: 50 type: string - description: 角色类型 (1:平台角色, 2:客户角色) in: query name: role_type schema: description: 角色类型 (1:平台角色, 2:客户角色) maximum: 2 minimum: 1 nullable: true type: integer - description: 状态 in: query name: status schema: description: 状态 maximum: 1 minimum: 0 nullable: true type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelRolePageResult' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 角色列表 tags: - 角色 post: requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelCreateRoleRequest' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelRoleResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 创建角色 tags: - 角色 /api/admin/roles/{id}: delete: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 删除角色 tags: - 角色 get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelRoleResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取角色详情 tags: - 角色 put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdateRoleParams' responses: "200": content: application/json: schema: $ref: '#/components/schemas/ModelRoleResponse' description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 更新角色 tags: - 角色 /api/admin/roles/{id}/permissions: get: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer responses: "200": content: application/json: schema: items: $ref: '#/components/schemas/ModelPermission' type: array description: OK "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 获取角色权限 tags: - 角色 post: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelAssignPermissionsParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 分配权限 tags: - 角色 /api/admin/roles/{id}/status: put: parameters: - description: ID in: path name: id required: true schema: description: ID minimum: 0 type: integer requestBody: content: application/json: schema: $ref: '#/components/schemas/ModelUpdateRoleStatusParams' responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 更新角色状态 tags: - 角色 /api/admin/roles/{role_id}/permissions/{perm_id}: delete: parameters: - description: 角色ID in: path name: role_id required: true schema: description: 角色ID minimum: 0 type: integer - description: 权限ID in: path name: perm_id required: true schema: description: 权限ID minimum: 0 type: integer responses: "400": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 请求参数错误 "401": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 未认证或认证已过期 "403": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 无权访问 "500": content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: 服务器内部错误 security: - BearerAuth: [] summary: 移除权限 tags: - 角色