保利威文档中心

幫助中心

直播答題-取得套題ID下所有題目的答題明細

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

介面URL

http://api.polyv.net/live/v2/qa/qarecords

介面說明

1、作用:取得套題ID下所有題目的答題明細
2、介面支援https協定

請求方式

GET

請求參數

參數名 必選 類型 說明
appId string 非業務參數,從API設定中取得,在直播系統登記的appid
sign string 非業務參數,簽名,32位大寫MD5值
timestamp string 目前時間毫秒級時間戳(13位,三分鐘有效)
groupId string 套題id

回應參數

參數名 說明
status 回應狀態
data 回應結果
code http回應狀態碼
msg 異常錯誤資訊
sequence 題目序號
answer 選項序號
isCorrectAnswer 是否正確答案,Y是,N否
unionId 選擇該選項使用者的unionId

回應成功JSON範例

{
  "code": 200,
  "status": "success",
  "message": "",
  "data": [
    {
      "sequence": 1,   
      "answer": "2",    
      "isCorrectAnswer": "Y",
      "unionId": "olHR9jkp5Bds7L072RZynM8qA8Iw"   
    },
    {
      "sequence": 1,
      "answer": "2",
      "isCorrectAnswer": "Y",
      "unionId": "olHR9jt2FUioJyq5t3s9vCR2ZBOQ"
    },
    {
      "sequence": 1,
      "answer": "2",
      "isCorrectAnswer": "Y",
      "unionId": "olHR9jrXrO8kfOrHc8Ul8FmhKdag"
    }
  ]
}

回應異常JSON範例

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

PHP請求範例

<?php
  $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/qa/qarecords?";
  echo file_get_contents($url."appId=$appId"."&timestamp=$timestamp"."&sign=$sign"."&groupId=$groupId");
?>

簽名規則:

​ 將非空的請求參數按照參數名字典順序排列,連接參數名與參數值,並在首尾加上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

联系客服,在线咨询