# 答题游戏接口说明
## 一. 说明

所有接口均需上传sessionid

通用返回JSON结构, 接口Response的数据结构说明只包含data部分
``` JSON
{
    "errcode": 0, //0:成功 2: 缺少必要参数(accountid, sessionid) 4: 帐号被封, 5: 帐号未找到 100: 所有未定义的错误
    "errmsg": "", //错误描述
    "data": {}, 	// 数据
}
```


## 二. 客户端接口列表

### 1. 获取关卡题目列表

1. Method: POST
2. URI: /api/:accountid/puzzle/list

| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| accountid | 帐号id                             |

> POST参数


| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| shop | 店铺id, 比如 607ff59d4a4e16687a3b7079 		|
| level | 关卡id		|
| type | 是否降低难度 0: 普通, 1: 降低难度		|

3. Response: JSON

```js
{
	session: "6080f330b9655b5c0467ee5a",			// 当前局的id,提交答案时必须上报该字段
	records: [{
    "id": "6080f330b9655b5c0467ee5e",         // 题目id
    "title": "“大丈夫为国捐躯，死而无憾！”这话是谁说的？",  // 问题
    "answers": [  // 可选答案
        "刘铭传",
        "徐骧",
        "刘步蟾",
        "刘永福"
    ],
    "category": "体育-体育",	// 类型
    "type": 1,   // 题目类型  1: 普通的文字选择题, 2: 图形
    "quality": 1 // 题目难度 
}]
}

```

### 2. 上报题目答案

1. Method: POST
2. URI: /api/:accountid/puzzle/answer

| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| accountid | 帐号id                             |

> POST参数


| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| id | 题目id  		|
| session | 当局的id, 从关卡题目列表中获取 |
| level | 关卡id		|
| answer | 回答的选项 |
| type | 回答类型, 0: 正常, 1: 超时 |
| mode | 游戏类型, 0: 单人, 1: 多人 |

3. Response: JSON

```js
{
    result: 1,  //答题结果 1: 正确, 0 : 错误
    gameResult: 0, // 当前局游戏结果 0: 未完成, -1: 失败, 1: 胜利
  	"stats": {	// 当局的状态
            "1111": {
                "answer": [	// 每一题的结果
                    1,
                    0
                ],
                "rightCount": 1,	// 答对的数量
                "errorCount": 1,	// 答错的数量
                "comboCount": 0,	// 当前连续答对的数量
                "maxCombo": 1,		// 当局连续答对的最大数量
                "score": 10,			// 当局胜利后的得分
                "gameResult": 0		// 当局的游戏结果, 单人的话和上一层gameResult相同
            }
    }
}
```
### 3. 开始匹配

1. Method: POST
2. URI: /api/:accountid/puzzle/match

| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| accountid | 帐号id                             |

> POST参数


| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| shop | 店铺id  		|
| debug_begin_sec | 游戏于n秒后开始, 最小2秒, 测试用  		|

3. Response: JSON

```js
		{
        "roomId": "mysWNuFnY",	//房间id
        "beginTime": 1619689073034, // 游戏的开始时间
        "sessionId": "adfadf"		// 当前用户在该房间的sessionId, 如果有该字段, 客户端在joinById的时候须带上该字段
        "session": "608baeea9d0fe70ccd54cf9c" // 当前局的id,提交答案时必须上报该字段
    }
```

### 4. 获取关卡更多题目

1. Method: POST
2. URI: /api/:accountid/puzzle/more

| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| accountid | 帐号id                             |

> POST参数


| 字段     | 说明                                   |
| -------- | -------------------------------------- |
| count | 需要获取的数量  		|
| session | 当局的id, 从关卡题目列表中获取		|
| quality | 难度		|

3. Response: JSON

```js
[{
    "id": "6080f330b9655b5c0467ee5e",         // 题目id
    "title": "“大丈夫为国捐躯，死而无憾！”这话是谁说的？",  // 问题
    "answers": [  // 可选答案
        "刘铭传",
        "徐骧",
        "刘步蟾",
        "刘永福"
    ],
    "category": "体育-体育",	// 类型
    "type": 1,   // 题目类型  1: 普通的文字选择题, 2: 图形
  	"quality": 1 // 题目难度 
}]