內容設計
接口功能說明
該接口由第三方開發(fā)者提供給人人秀調用，適用于答題類活動。
第三方題庫
開發(fā)注意：
該接口由第三方開發(fā)者提供給人人秀調用，必須設置該接口地址
開發(fā)者接收到參數(shù)，必須先將參數(shù)urldecode處理，然后計算簽名
請求地址 | 由第三方平臺提供 | |
請求方式 | POST | |
參數(shù)名稱 | 是否必須 | 說明 |
app_key | 是 | 人人秀平臺分配的AppKey |
time_stamp | 是 | 1970-01-01開始的時間戳，精確到毫秒 |
sign | 是 | 根據(jù)簽名算法所得，如何計算簽名 |
data_type | 是 | data_type=1時返回題庫列表； data_type=2時返回對應題庫中的題目數(shù)據(jù)； |
question_id | 是 | data_type=2時必填，題庫id |
login_id | 否 | 子賬號登錄時返回 |
page | 是 | 第幾頁數(shù)據(jù) |
limit | 是 | 每頁多少條數(shù)據(jù) |
返回JSON格式結果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
參數(shù)名稱 | 說明 | |
result | 0表示成功，1表示失敗 | |
msg | 表示失敗詳細描述 | |
data | 成功時，返回對應數(shù)據(jù) | |
data參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
total | 是 | 數(shù)據(jù)總筆數(shù) |
rows | 是 | 數(shù)據(jù)列表 |
data_type = 1 時返回題庫列表 rows參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
id | 是 | 題庫id |
title | 是 | 題庫名稱 |
question_count | 是 | 當前題庫中題目數(shù)量 |
data_type = 2 時返回題庫題目 rows參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
type | 是 | 題目類型，text文本，image圖片，music音頻 |
score | 是 | 題目分數(shù) |
question | 是 | 題目 |
image | 否 | 圖片地址 |
music | 否 | 音頻地址 |
result | 是 | 題目選項及答案，數(shù)組Array |
result 題目選項及答案參數(shù)說明
參數(shù)名稱 | 是否必須 | 說明 |
value | 是 | 題目選項內容，題目 |
right | 是 | 是否正確答案，布爾值true或false |
對接步驟
第一步，對接收的參數(shù)進行urldecode處理
第二步，計算簽名和驗證簽名
第三步，返回處理結果，返回值必須是json格式 Content-type: application/json
請求示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"data_type":1,
"question_id":0,
"login_id":"",
"page ":1,
"limit ":20
}
返回值示例，data_type=1,獲取題目列表，json格式 Content-type: application/json
{
"result": 0,
"data": {
"total": 1,
"rows": [
{
"id": 1,
"title": "題目標題",
"question_count": 10
}
]
},
"msg": "ok"
}
返回值示例，data_type=2，獲取題目內容，json格式 Content-type: application/json
{
"result": 0,
"data": {
"total": 1,
"rows": [
{
"type": "text",
"question": "題目標題",
"score": 10,
"image": "https://third.com/imageurl.jpg",
"music": "https://third.com/musicurl.mp3",
"result": [
{"value": "選項1","right": true},
{"value": "選項2","title": false},
]
}
]
},
"msg": "ok"
}
題庫顯示效果示例
相關文檔
