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

更新时间：2022-05-23 19:00:06

接口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示例：

{
    "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
  $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

POLYV 帮助中心