商户赛事管理接口字段清单
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 |
否 |
姓名/手机号搜索 |