内容设计
接口功能说明
该接口由第三方开发者提供给人人秀调用，适用于答题类活动。
第三方题库
开发注意：
该接口由第三方开发者提供给人人秀调用，必须设置该接口地址
开发者接收到参数，必须先将参数urldecode处理，然后计算签名
请求地址 | 由第三方平台提供 | |
请求方式 | POST | |
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳，精确到毫秒 |
sign | 是 | 根据签名算法所得，如何计算签名 |
data_type | 是 | data_type=1时返回题库列表； data_type=2时返回对应题库中的题目数据； |
question_id | 是 | data_type=2时必填，题库id |
login_id | 否 | 子账号登录时返回 |
page | 是 | 第几页数据 |
limit | 是 | 每页多少条数据 |
返回JSON格式结果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
参数名称 | 说明 | |
result | 0表示成功，1表示失败 | |
msg | 表示失败详细描述 | |
data | 成功时，返回对应数据 | |
data参数说明
参数名称 | 是否必须 | 说明 |
total | 是 | 数据总笔数 |
rows | 是 | 数据列表 |
data_type = 1 时返回题库列表 rows参数说明
参数名称 | 是否必须 | 说明 |
id | 是 | 题库id |
title | 是 | 题库名称 |
question_count | 是 | 当前题库中题目数量 |
data_type = 2 时返回题库题目 rows参数说明
参数名称 | 是否必须 | 说明 |
type | 是 | 题目类型，text文本，image图片，music音频 |
score | 是 | 题目分数 |
question | 是 | 题目 |
image | 否 | 图片地址 |
music | 否 | 音频地址 |
result | 是 | 题目选项及答案，数组Array |
result 题目选项及答案参数说明
参数名称 | 是否必须 | 说明 |
value | 是 | 题目选项内容，题目 |
right | 是 | 是否正确答案，布尔值true或false |
对接步骤
第一步，对接收的参数进行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"
}
题库显示效果示例
相关文档
