Files
jurong_circle_agent_black/docs/apis/transfers.js
2025-09-05 16:49:23 +08:00

134 lines
4.0 KiB
JavaScript

/**
* @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: 服务器错误
*/