成绩与排名接口字段清单
1. 商户录入成绩
- 接口路径:
POST /api/merchant/results/import
- 功能说明:批量导入或提交成绩。
请求参数
| 字段 |
类型 |
必填 |
说明 |
| eventId |
string |
是 |
赛事ID |
| groupId |
string |
是 |
组别ID |
| resultList |
array |
是 |
成绩列表 |
2. 发布成绩
- 接口路径:
POST /api/merchant/results/publish
- 功能说明:发布成绩并生成用户可见排名。
请求参数
| 字段 |
类型 |
必填 |
说明 |
| eventId |
string |
是 |
赛事ID |
| groupId |
string |
否 |
指定组别 |
返回字段
| 字段 |
类型 |
说明 |
| publishStatus |
string |
发布结果 |
| publishedCount |
number |
发布记录数 |
3. 用户查询成绩
- 接口路径:
GET /api/user/results
- 功能说明:查询用户自己的成绩与排名。
查询参数
| 字段 |
类型 |
必填 |
说明 |
| eventId |
string |
否 |
赛事ID |
返回字段
| 字段 |
类型 |
说明 |
| eventName |
string |
赛事名称 |
| groupName |
string |
组别 |
| totalScore |
number |
总成绩 |
| rank |
number |
排名 |
| resultStatus |
string |
成绩状态 |