保利威文档中心

帮助中心

直播答题-获取套题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

联系客服,在线咨询