159 lines
4.3 KiB
JavaScript
159 lines
4.3 KiB
JavaScript
|
/**
|
|||
|
|
* @swagger
|
|||
|
|
* tags:
|
|||
|
|
* name: Matching
|
|||
|
|
* description: 匹配订单相关接口
|
|||
|
|
*/
|
|||
|
|
/**
|
|||
|
|
* @swagger
|
|||
|
|
* /api/matching/my-orders:
|
|||
|
|
* get:
|
|||
|
|
* summary: 获取用户的匹配订单列表
|
|||
|
|
* tags: [Matching]
|
|||
|
|
* security:
|
|||
|
|
* - bearerAuth: []
|
|||
|
|
* parameters:
|
|||
|
|
* - in: query
|
|||
|
|
* name: page
|
|||
|
|
* schema:
|
|||
|
|
* type: integer
|
|||
|
|
* default: 1
|
|||
|
|
* description: 页码
|
|||
|
|
* - in: query
|
|||
|
|
* name: limit
|
|||
|
|
* schema:
|
|||
|
|
* type: integer
|
|||
|
|
* default: 10
|
|||
|
|
* description: 每页数量
|
|||
|
|
* responses:
|
|||
|
|
* 200:
|
|||
|
|
* description: 成功获取匹配订单列表
|
|||
|
|
* content:
|
|||
|
|
* application/json:
|
|||
|
|
* schema:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* success:
|
|||
|
|
* type: boolean
|
|||
|
|
* data:
|
|||
|
|
* type: array
|
|||
|
|
* items:
|
|||
|
|
* $ref: '#/components/schemas/MatchingOrder'
|
|||
|
|
* 401:
|
|||
|
|
* description: 未授权
|
|||
|
|
* 500:
|
|||
|
|
* description: 服务器错误
|
|||
|
|
*/
|
|||
|
|
/**
|
|||
|
|
* @swagger
|
|||
|
|
* components:
|
|||
|
|
* schemas:
|
|||
|
|
* MatchingOrder:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* id:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 匹配订单ID
|
|||
|
|
* initiator_id:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 发起人ID
|
|||
|
|
* matching_type:
|
|||
|
|
* type: string
|
|||
|
|
* enum: [small, large]
|
|||
|
|
* description: 匹配类型（小额或大额）
|
|||
|
|
* amount:
|
|||
|
|
* type: number
|
|||
|
|
* description: 匹配总金额
|
|||
|
|
* status:
|
|||
|
|
* type: string
|
|||
|
|
* enum: [pending, matching, completed, failed]
|
|||
|
|
* description: 订单状态
|
|||
|
|
* created_at:
|
|||
|
|
* type: string
|
|||
|
|
* format: date-time
|
|||
|
|
* description: 创建时间
|
|||
|
|
* Allocation:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* id:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 分配ID
|
|||
|
|
* from_user_id:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 发送方用户ID
|
|||
|
|
* to_user_id:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 接收方用户ID
|
|||
|
|
* amount:
|
|||
|
|
* type: number
|
|||
|
|
* description: 分配金额
|
|||
|
|
* cycle_number:
|
|||
|
|
* type: integer
|
|||
|
|
* description: 轮次编号
|
|||
|
|
* status:
|
|||
|
|
* type: string
|
|||
|
|
* enum: [pending, confirmed, rejected, cancelled]
|
|||
|
|
* description: 分配状态
|
|||
|
|
* created_at:
|
|||
|
|
* type: string
|
|||
|
|
* format: date-time
|
|||
|
|
* description: 创建时间
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @swagger
|
|||
|
|
* /api/matching/create:
|
|||
|
|
* post:
|
|||
|
|
* summary: 创建匹配订单
|
|||
|
|
* tags: [Matching]
|
|||
|
|
* security:
|
|||
|
|
* - bearerAuth: []
|
|||
|
|
* requestBody:
|
|||
|
|
* required: true
|
|||
|
|
* content:
|
|||
|
|
* application/json:
|
|||
|
|
* schema:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* matchingType:
|
|||
|
|
* type: string
|
|||
|
|
* enum: [small, large]
|
|||
|
|
* default: small
|
|||
|
|
* description: 匹配类型（小额或大额）
|
|||
|
|
* customAmount:
|
|||
|
|
* type: number
|
|||
|
|
* description: 大额匹配时的自定义金额（5000-50000之间）
|
|||
|
|
* responses:
|
|||
|
|
* 200:
|
|||
|
|
* description: 匹配订单创建成功
|
|||
|
|
* content:
|
|||
|
|
* application/json:
|
|||
|
|
* schema:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* success:
|
|||
|
|
* type: boolean
|
|||
|
|
* message:
|
|||
|
|
* type: string
|
|||
|
|
* data:
|
|||
|
|
* type: object
|
|||
|
|
* properties:
|
|||
|
|
* matchingOrderId:
|
|||
|
|
* type: integer
|
|||
|
|
* amounts:
|
|||
|
|
* type: array
|
|||
|
|
* items:
|
|||
|
|
* type: number
|
|||
|
|
* matchingType:
|
|||
|
|
* type: string
|
|||
|
|
* totalAmount:
|
|||
|
|
* type: number
|
|||
|
|
* 400:
|
|||
|
|
* description: 参数错误或用户未满足匹配条件
|
|||
|
|
* 401:
|
|||
|
|
* description: 未授权
|
|||
|
|
* 404:
|
|||
|
|
* description: 用户不存在
|
|||
|
|
* 500:
|
|||
|
|
* description: 服务器错误
|
|||
|
|
*/
|