保利威文档中心

幫助中心

直播答題-取得套題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

联系客服,在线咨询
在线咨询