47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# 成绩与排名接口字段清单
|
|
|
|
## 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 | 成绩状态 |
|