# 成绩与排名接口字段清单

## 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 | 成绩状态 |