# 直播答题-获取频道下所有套题信息

### 接口URL

```
http://api.polyv.net/live/v2/channels/{channelId}/qa-groups
（注：{channelId}是频道ID）
```

### 接口说明

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

### 支持格式

```
JSON
```

### 请求方式

```
GET
```

### 请求数限制

```
TRUE
```

### 请求参数

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

### 响应成功JSON示例：

```json
{
    "code": 200, 
    "status": "success", 
    "message": "", 
    "data": {
         [
            {
                "groupId": "ab96d8f651", 
                "channelId": 10001, 
                "userId": "7d26575efe", 
                "name": "套题1", 
                "amount": 1000, 
				"awardUnit":"比特币",
                "countDown": 10, 
				"status":"end"
                "createdTime": "2018-01-22 00:00:00", 
                "lastModified": "2018-01-22 00:00:00", 
                "startTime": "2018-01-22 00:00:00"
            }, 
            {
                "groupId": "ab96d8f651", 
                "channelId": 10001, 
                "userId": "7d26575efe", 
                "name": "套题1", 
                "amount": 1000, 
				"awardUnit":"比特币",				
                "countDown": 10, 
				"status":"end"
                "createdTime": "2018-01-22 00:00:00", 
                "lastModified": "2018-01-22 00:00:00", 
                "startTime": "2018-01-22 00:00:00"
            }
        ]
    }
}
```

### 字段说明

| 参数名          | 说明                        |
| ------------ | ------------------------- |
| status       | 响应状态                      |
| data         | 响应结果                      |
| message      | 异常错误信息                    |
| groupId      | 套题的ID                     |
| channelId    | 直播频道id                    |
| userId       | 用户id                      |
| name         | 套题名称                      |
| amount       | 奖励数量                      |
| awardUnit    | 奖励单位                      |
| countDown    | 每题的答题时长                   |
| status       | 套题状态：N（未使用） E（已结束） P（进行中） |
| createdTime  | 创建时间                      |
| lastModified | 最后修改日期                    |
| startTime    | 答题开始时间                    |

### php请求示例

```php
<?php
  $appId = "epxt70r96u";
  $timestamp = time()*1000;
  $channelId = "124545";
  $appSecret = "cb4a16edc2ef4f78941e00cd0b3bd867";
  $str = $appSecret."appId$appId"."timestamp$timestamp".$appSecret;
  $sign = strtoupper(md5($str));
  $url = "http://api.live.polyv.net/v2/channels/$channelId/qa-groups?";
  echo file_get_contents($url."appId=$appId"."&timestamp=$timestamp"."&sign=$sign");
?>
```

### 签名规则：

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

​ 2、将请求参数按照参数名字典顺序排列 ​ appId = "egymbtsf38" ​ timestamp = "1494399085000"

​ 3、连接字符串 连接参数名与参数值,并在首尾加上appSecret（此处appSecret的值为6ef8d34c08f44e91a18428842ff0ba7e），如下： ​ 6ef8d34c08f44e91a18428842ff0ba7eappIdegymbtsf38timestamp14943990850006ef8d34c08f44e91a18428842ff0ba7e

​ 4、生成32位大写MD5值签名sign ​ 9291DE270E8C79FD4B805CDD45B6BC2B