分頁查詢帳號的問答題目
更新時間:2026-01-20 14:07:15
介面描述
1、分页查询账号的问答题目,支持按视频筛选
2、接口支持https协议
介面URL
http://api.polyv.net/v2/video/list-video-exam
請求方式
GET
介面限制
1、介面同時支援HTTP、HTTPS,建議使用HTTPS確保介面安全,介面呼叫有頻率限制,詳細請查看
請求參數描述
| 參數名 | 必填 | 類型 | 說明 |
|---|---|---|---|
| userid | true | String | 保利威點播帳戶id,可參考【取得密鑰】取得,取得路徑:官網->登入->點播(API介面) |
| ptime | true | Long | 當前時間的毫秒級時間戳,3分鐘內有效 |
| sign | true | String | 簽名,為40位大寫的SHA1值,產生簽名的secretkey密鑰作為通訊資料安全的關鍵資訊,嚴禁儲存在用戶端直接使用,所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料【詳見簽名產生規則】 |
| vid | false | String | 影片id,該參數為空則查詢該帳號下所有的問答題目 |
| page | false | Integer | 頁碼,從1開始,預設1 |
| pageSize | false | Integer | 每頁筆數,預設10,最大1000 |
範例
http://api.polyv.net/v2/video/list-video-exam
表單參數:
userid=1b448be323&ptime=1620287966337&sign=738445A034D8F70D3625E0C761EE26A4E9F3446B&vid=1b448be3231ebf0005ec631a7e4247ee_1&page=1&pageSize=10
回應參數描述
| 參數名 | 類型 | 說明 |
|---|---|---|
| code | Integer | 回應狀態碼,200為成功返回,非200為失敗【詳見全域錯誤說明】 |
| status | String | 回應狀態文字資訊 |
| message | String | 回應描述資訊,當code為400或500時,輔助描述錯誤原因 |
| data | Object | 回應成功時返回分頁資料,失敗時返回空【詳見data欄位說明】 |
data欄位描述
| 欄位 | 類型 | 說明 |
|---|---|---|
| pageNumber | Integer | 當前頁碼 |
| pageSize | Integer | 每頁筆數 |
| totalItems | Long | 總記錄數 |
| totalPages | Integer | 總頁數 |
| contents | Array | 問答列表【詳見contents欄位說明】 |
contents欄位描述
| 欄位 | 類型 | 說明 |
|---|---|---|
| vid | String | 影片ID |
| examId | String | 問答ID |
| showTime | Integer | 問答出現的時間,單位:秒 |
| qustion | String | 問答題目描述 |
| choices | String | 問答選項內容,格式為json陣列,每個題目最多5個選項 |
| canSkip | Boolean | 是否可跳過,預設值:false |
| explanationIfRight | String | 回答正確後的解答詳情 |
| showExplanationIfWrong | String | 回答錯誤後是否顯示解答詳情 |
| explanationIfWrong | Boolean | 回答錯誤後的解答詳情 |
| backTime | Integer | 答錯後回退到第幾秒,-1代表不回退,預設為-1 |
| status | Integer | 是否有效,1:有效,0:無效,預設為1 |
| type | Integer | 題目類型,0:選擇題,1:聽力題(聽力題即將下線) |
| mp3url | String | 聽力題的mp3音訊檔案url(聽力題即將下線) |
| illustration | String | 問答圖片url |
| createdTime | Long | 問答建立時間,格式為13位時間戳,例如 1767003468000 |
Java請求範例
快速接入基礎程式碼請下載相關依賴原始碼, 點擊下載原始碼 ,下載後加入到自己的原始碼工程中即可。測試案例中的HttpUtil.java 和 VodSignUtil.java 都包含在下載檔案中。
強烈建議您使用點播Java SDK完成API的功能對接,點播Java SDK 對API呼叫邏輯、異常處理、資料簽名、HTTP請求執行緒池進行了統一封裝和最佳化。
private static final Logger log = LoggerFactory.getLogger(VodVideoManageManagementTest.class);
/**
* 分页查询问答题目
*/
@Test
public void testListQuiz() throws Exception, NoSuchAlgorithmException {
//公共参数,填写自己的实际参数
String secretKey = super.secretKey;
String userId = super.userId;
String ptime = String.valueOf(System.currentTimeMillis());
String url = "http://api.polyv.net/v2/video/list-video-exam";
//调用参数
Map<String, String> requestMap = new HashMap<>();
requestMap.put("userid", userId);
requestMap.put("ptime", ptime);
requestMap.put("page", "1");
requestMap.put("pageSize", "10");
requestMap.put("sign", VodSignUtil.getSign(requestMap, secretKey));
String response = HttpUtil.get(url, requestMap);
log.debug("测试分页查询问答题目,{}", response);
//do something
}
回應範例
系統全域錯誤說明詳見全域錯誤說明
成功範例
{
"code": 200,
"status": "success",
"message": "success",
"data": {
"pageNumber": 1,
"pageSize": 10,
"totalItems": 2,
"totalPages": 1,
"contents": [
{
"examId": "179407cbb9b",
"vid": "1b448be3231ebf0005ec631a7e4247ee_1",
"showTime": 3,
"question": "测试删除问答",
"choices": "[{\"index\":0,\"content\":\"1\",\"right\":false},{\"index\":1,\"content\":\"2\",\"right\":true}]",
"explanationIfRight": "123",
"explanationIfWrong": "321",
"showExplanationIfWrong": true,
"backTime": 1,
"canSkip": true,
"illustration": null,
"type": 0,
"mp3Url": "",
"status": 1,
"createdTime": 1620284587000
}
]
}
}
異常範例
簽名不正確
{
"code": 400,
"status": "error",
"message": "the sign is not right",
"data": ""
}
時間戳過期
{
"code": 400,
"status": "error",
"message": "ptime is too old.",
"data": ""
}
