直播答題-根據套題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