直播答題-取得套題ID下所有的題目資訊

更新時間：2022-05-16 10:08:41

介面URL

http://api.polyv.net/live/v2/channels/{channelId}/qa-questions
（注：{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)
option1	選擇項1
option2	選擇項2
option3	選擇項3
option4	選擇項4
option5	選擇項4
answer	答案：1 2 3 4 5
createdTime	建立時間
lastModified	最後修改時間

回應成功JSON範例

{
  code: 200,
  status: "success",
  message: "",
  data: [
      {
      questionId: "i6ro0hxj00",
      groupId: "i6ro0hxj00",	  
      channelId: 10001,
      userId: "i6ro0hxj00",
      name: "题目1",
      type: "R",
      option1: "选择项1",
      option2: "选择项2",
      option3: "选择项3",
      option4: "选择项4",
      option5: "选择项5",	  
      answer: "1",
      createdTime: "2018-01-22 00:00:00",
      lastModified: "2018-01-22 00:00:00"	  
    },
      {
      questionId: "i6ro0hxj00",
      groupId: "i6ro0hxj00",	  
      channelId: 10001,
      userId: "i6ro0hxj00",
      name: "题目1",
      type: "R",
      option1: "选择项1",
      option2: "选择项2",
      option3: "选择项3",
      option4: "选择项4",
      option5: "选择项5",	  
      answer: "1",
      createdTime: "2018-01-22 00:00:00",
      lastModified: "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