54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# 商户赛事管理接口字段清单
|
|
|
|
## 1. 创建赛事
|
|
- 接口路径：`POST /api/merchant/events`
|
|
- 功能说明：商户创建赛事草稿。
|
|
|
|
### 请求参数
|
|
| 字段 | 类型 | 必填 | 说明 |
|
|
| --- | --- | --- | --- |
|
|
| eventName | string | 是 | 赛事名称 |
|
|
| eventCover | string | 是 | 封面图 |
|
|
| eventIntro | string | 是 | 简介 |
|
|
| location | string | 是 | 比赛地点 |
|
|
| startTime | string | 是 | 开赛时间 |
|
|
| endTime | string | 是 | 结束时间 |
|
|
| signupStartTime | string | 是 | 报名开始时间 |
|
|
| signupEndTime | string | 是 | 报名截止时间 |
|
|
| refundRule | string | 是 | 退款规则 |
|
|
| groupConfigList | array | 是 | 组别配置 |
|
|
|
|
### 返回字段
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| eventId | string | 新创建的赛事ID |
|
|
| eventStatus | string | 当前状态，通常为草稿 |
|
|
|
|
## 2. 提交赛事审核
|
|
- 接口路径：`POST /api/merchant/events/{eventId}/submit-review`
|
|
- 功能说明：将赛事从草稿提交为待审核。
|
|
|
|
### 请求参数
|
|
| 字段 | 类型 | 必填 | 说明 |
|
|
| --- | --- | --- | --- |
|
|
| eventId | string | 是 | 赛事ID |
|
|
|
|
### 返回字段
|
|
| 字段 | 类型 | 说明 |
|
|
| --- | --- | --- |
|
|
| eventId | string | 赛事ID |
|
|
| reviewStatus | string | 待审核 |
|
|
|
|
## 3. 查询报名列表
|
|
- 接口路径：`GET /api/merchant/signups`
|
|
- 功能说明：查询本商户下赛事的报名记录。
|
|
|
|
### 查询参数
|
|
| 字段 | 类型 | 必填 | 说明 |
|
|
| --- | --- | --- | --- |
|
|
| eventId | string | 否 | 赛事ID |
|
|
| groupId | string | 否 | 组别ID |
|
|
| signupStatus | string | 否 | 报名状态 |
|
|
| payStatus | string | 否 | 支付状态 |
|
|
| keyword | string | 否 | 姓名/手机号搜索 |
|