/** * @swagger * tags: * name: 转账管理 * description: 转账记录管理相关接口 */ /** * @swagger * /transfers: * get: * summary: 获取代理下级用户转账记录列表 * tags: [转账管理] * security: * - bearerAuth: [] * parameters: * - in: query * name: page * schema: * type: integer * default: 1 * description: 页码 * - in: query * name: limit * schema: * type: integer * default: 10 * description: 每页数量 * - in: query * name: search * schema: * type: string * description: 搜索关键词(用户名、手机号、转账单号) * - in: query * name: status * schema: * type: string * enum: [pending, success, failed, cancelled] * description: 转账状态 * - in: query * name: type * schema: * type: string * enum: [deposit, withdraw, transfer] * description: 转账类型 * - in: query * name: start_date * schema: * type: string * format: date * description: 开始日期 * - in: query * name: end_date * schema: * type: string * format: date * description: 结束日期 * - in: query * name: min_amount * schema: * type: number * description: 最小金额 * - in: query * name: max_amount * schema: * type: number * description: 最大金额 * - in: query * name: sort_by * schema: * type: string * default: created_at * description: 排序字段 * - in: query * name: sort_order * schema: * type: string * enum: [asc, desc] * default: desc * description: 排序方向 * responses: * 200: * description: 获取成功 * content: * application/json: * schema: * type: object * properties: * success: * type: boolean * example: true * data: * type: object * properties: * transfers: * type: array * items: * $ref: '#/components/schemas/Transfer' * total: * type: integer * description: 总记录数 * page: * type: integer * description: 当前页码 * limit: * type: integer * description: 每页数量 * totalPages: * type: integer * description: 总页数 * stats: * type: object * properties: * totalAmount: * type: number * format: decimal * description: 总转账金额 * successAmount: * type: number * format: decimal * description: 成功转账金额 * pendingAmount: * type: number * format: decimal * description: 待处理转账金额 * failedAmount: * type: number * format: decimal * description: 失败转账金额 * 401: * description: 未授权 * 500: * description: 服务器错误 */