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

更新时间：2022-05-16 10:08:41

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

{
  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示例

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

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

POLYV 帮助中心