直播答題-取得頻道下所有套題資訊

更新時間：2022-05-23 19:00:06

介面URL

http://api.polyv.net/live/v2/channels/{channelId}/qa-groups
（註：{channelId}是頻道ID）

介面說明

1、作用：取得頻道下的套題列表資訊。
2、介面支援https協定

支援格式

JSON

請求方式

GET

請求數限制

TRUE

請求參數

參數名	必選	類型	說明
appId	是	string	非業務參數，從API設定中取得，在直播系統登記的appId
timestamp	是	string	目前時間毫秒級時間戳（13位，三分鐘有效）
channelId	是	string	頻道號
sign	是	string	校驗簽名，32位大寫MD5值

響應成功JSON範例：

{
    "code": 200, 
    "status": "success", 
    "message": "", 
    "data": {
         [
            {
                "groupId": "ab96d8f651", 
                "channelId": 10001, 
                "userId": "7d26575efe", 
                "name": "套题1", 
                "amount": 1000, 
                "awardUnit":"比特币",
                "countDown": 10, 
                "status":"end"
                "createdTime": "2018-01-22 00:00:00", 
                "lastModified": "2018-01-22 00:00:00", 
                "startTime": "2018-01-22 00:00:00"
            }, 
            {
                "groupId": "ab96d8f651", 
                "channelId": 10001, 
                "userId": "7d26575efe", 
                "name": "套题1", 
                "amount": 1000, 
                "awardUnit":"比特币",				
                "countDown": 10, 
                "status":"end"
                "createdTime": "2018-01-22 00:00:00", 
                "lastModified": "2018-01-22 00:00:00", 
                "startTime": "2018-01-22 00:00:00"
            }
        ]
    }
}

欄位說明

參數名	說明
status	響應狀態
data	響應結果
message	異常錯誤資訊
groupId	套題的ID
channelId	直播頻道id
userId	使用者id
name	套題名稱
amount	獎勵數量
awardUnit	獎勵單位
countDown	每題的答題時長
status	套題狀態：N（未使用） E（已結束） P（進行中）
createdTime	建立時間
lastModified	最後修改日期
startTime	答題開始時間

php請求範例

<?php
  $appId = "epxt70r96u";
  $timestamp = time()*1000;
  $channelId = "124545";
  $appSecret = "cb4a16edc2ef4f78941e00cd0b3bd867";
  $str = $appSecret."appId$appId"."timestamp$timestamp".$appSecret;
  $sign = strtoupper(md5($str));
  $url = "http://api.live.polyv.net/v2/channels/$channelId/qa-groups?";
  echo file_get_contents($url."appId=$appId"."&timestamp=$timestamp"."&sign=$sign");
?>

簽名規則：

將請求參數按照參數名字典順序排列，連接參數名與參數值，並在首尾加上appSecret，生成32位大寫MD5值，作為sign。以下是範例過程： 1、請求參數為： timestamp = "1494399085000" appId = "egymbtsf38"

2、將請求參數按照參數名字典順序排列 appId = "egymbtsf38" timestamp = "1494399085000"

3、連接字串連接參數名與參數值，並在首尾加上appSecret（此處appSecret的值為6ef8d34c08f44e91a18428842ff0ba7e），如下： 6ef8d34c08f44e91a18428842ff0ba7eappIdegymbtsf38timestamp14943990850006ef8d34c08f44e91a18428842ff0ba7e

4、生成32位大寫MD5值簽名sign 9291DE270E8C79FD4B805CDD45B6BC2B