Live Quiz - Retrieve Answer Details for All Questions Under a Question Set ID

Updated: 2022-05-16 10:08:41

Interface URL

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

Interface Description

Function: Retrieve answer details for all questions under a question set ID
The interface supports HTTPS protocol

Request Method

GET

Request Parameters

Parameter	Required	Type	Description
appId	Yes	string	Non-business parameter, obtained from API settings, the appid registered in the live system
sign	Yes	string	Non-business parameter, signature, 32-character uppercase MD5 value
timestamp	Yes	string	Current time in milliseconds (13 digits, valid for 3 minutes)
groupId	Yes	string	Question set ID

Response Parameters

Parameter	Description
status	Response status
data	Response result
code	HTTP response status code
msg	Error message
sequence	Question sequence number
answer	Option sequence number
isCorrectAnswer	Whether it is the correct answer, Y for yes, N for no
unionId	The unionId of the user who selected this option

Successful Response JSON Example

{
  "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"
    }
  ]
}

Error Response JSON Example

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

PHP Request Example

<?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");
?>

Signature Rules:

Arrange non-empty request parameters in dictionary order by parameter name, concatenate parameter names and values, prepend and append the appSecret, then generate a 32-character uppercase MD5 value as the sign. Example process:

1. Request parameters: timestamp = 1488277559000 appId = "egzq0dunak" groupId = "jjksiiijjd"

2. Arrange request parameters in dictionary order: appId = "egzq0dunak" groupId = "jjksiiijjd" timestamp = 1488277559000

3. Concatenate string: Concatenate parameter names and values, prepend and append the appSecret (appSecret value is 9018067824634261bd5733c6131ce35f), as follows: 9018067824634261bd5733c6131ce35fappIdegzq0dunakgroupIdjjksiiijjdtimestamp14882779750009018067824634261bd5733c6131ce35f

4. Generate signature sign: 7D3C7E4DF08A952A9949C51E0F426782

POLYV Help Center