# 直播答题-根据套题Id获取通关用户列表

### 接口URL

```
http://api.polyv.net/live/v2/channels/{channelId}/qa-record
（注：{channelId}为频道号）
```

### 接口说明

```
1、作用：获取频道套题下的通关用户列表
2、接口支持https协议
```

### 请求方式

```
GET
```

### 请求参数

| 参数名       | 必选 | 类型     | 说明                            |
| --------- | -- | ------ | ----------------------------- |
| appId     | 是  | string | 非业务参数，从API设置中获取，在直播系统登记的appid |
| sign      | 是  | string | 非业务参数，签名，32位大写MD5值            |
| timestamp | 是  | string | 当前时间毫秒级时间戳（13位，三分钟有效）         |
| groupId   | 是  | string | 字符串                           |

#### 响应参数

| 参数名         | 说明           |
| ----------- | ------------ |
| status      | 响应状态         |
| data        | 响应结果         |
| code        | http响应状态码    |
| msg         | 异常错误信息       |
| questionId  | 题目ID         |
| groupId     | 套题ID         |
| channelId   | 频道号          |
| userId      | 用户ID         |
| name        | 题目名称         |
| type        | 题目类型：单选(R)   |
| answer      | 答案：1 2 3 4 5 |
| openId      | 微信小程序openId  |
| unionId     | 微信unionId    |
| createdTime | 创建时间         |

### 响应成功JSON示例

```json
{
  code: 200,
  status: "success",
  message: "",
  data: [
  	{
      questionId: "i6ro0hxj00",
      groupId: "i6ro0hxj00",	  
      channelId: 10001,
      userId: "i6ro0hxj00",
      name: "题目1",
      type: "R",	  
      answer: "1",
	  openId: "1skkkkds",
	  unionId: "1dfdkjfalksdfjaks",
      createdTime: "2018-01-22 00:00:00" 
    },
  	{
      questionId: "i6ro0hxj00",
      groupId: "i6ro0hxj00",	  
      channelId: 10001,
      userId: "i6ro0hxj00",
      name: "题目1",
      type: "R",	  
      answer: "1",
	  openId: "1skkkkds",
	  unionId: "1dfdkjfalksdfjaks",
      createdTime: "2018-01-22 00:00:00" 
    }
  ]
}
```

### 响应异常JSON示例

```json
{
  code: 400,
  status: "error",
  message: "invalid timestamp.",
  data: ""
}
```

### PHP请求示例

```php
<?php
  $channelId="89001";
  $groupId="1kdjihdhj";
  $appId="egzq0dunak";
  $appSecret="9018067824634261bd5733c6131ce35f";
  $timestamp = time()*1000;
  $str = $appSecret."appId".$appId."groupId$groupId".timestamp".$timestamp.$appSecret;
  $sign=strtoupper(md5($str));

  $url="http://api.polyv.net/live/v2/channels/$channelId/qa-questions?appId=".$appId."&timestamp=".$timestamp."&sign=".$sign."&groupId=".groupId;

  $ch = curl_init() or die ( curl_error() );
  curl_setopt( $ch, CURLOPT_URL, $url);
  curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
  curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, 360);
  $response = curl_exec ( $ch );
  curl_close ( $ch );
  echo $response;
?>
```

### 签名规则：

​ 将非空的请求参数按照参数名字典顺序排列，连接参数名与参数值,并在首尾加上appSecret，生成32位大写MD5值，作为sign。 以下是示例过程：

​ **1、请求参数为** ​ timestamp =1488277559000 ​ appId = "egzq0dunak" ​ groupId="jjksiiijjd"

​ **2、将请求参数按照参数名字典顺序排列** ​ appId = "egzq0dunak" ​ groupId="jjksiiijjd" ​ timestamp =1488277559000

​ **3、连接字符串** 连接参数名与参数值,并在首尾加上appSecret（appSecret的值为9018067824634261bd5733c6131ce35f），如下： 9018067824634261bd5733c6131ce35fappIdegzq0dunakgroupIdjjksiiijjdtimestamp14882779750009018067824634261bd5733c6131ce35f

​ **4、生成签名sign** 7D3C7E4DF08A952A9949C51E0F426782