接口功能说明
该接口由第三方开发者提供给人人秀调用，用于年度账单活动。对接API查询自有数据结果，生成账单海报。
开发注意：
该接口由第三方开发者提供给人人秀调用，必须设置该接口地址
开发者接收到参数，必须先将参数urldecode处理，然后计算签名
请求地址 | 由第三方平台提供 | |
请求方式 | POST方式，Content-type：application/x-www-form-urlencoded | |
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳，精确到毫秒 |
sign | 是 | 根据签名算法所得，如何计算签名 |
activity_guid | 是 | 具体活动guid标识，如何获取互动ID |
h5_guid | 是 | h5标记来自人人秀哪个活动 |
openid | 是 | 用户的ID |
query_condition | 是 | 查询条件参数列表，json字符串对象。 参数示例： "[{"key":"'学号'","value":"230232"},{"key":"'姓名'","value":"张三"}]" |
| field_list | 是 | 数据字段类型列表：json字符串对象，按设置顺序排序，返回数据时也需按照此顺序返回数据 field_list示例值 ： "["学号","姓名","性别","语文","数学","英语"]" |
返回JSON格式结果 Content-type: application/json | ||
{"result":0,"msg":"","data":{}} | ||
参数名称 | 说明 | |
result | 0表示成功，1表示失败 | |
msg | 表示失败详细描述 | |
data | 成功时，返回对应数据 参数示例： "[{"key":"'学号'","value":"230323"},{"key":"'姓名'","value":"张三"}]" | |
接口对接步骤
第一步，对接收的参数进行urldecode处理
第二步，计算签名和验证签名
第三步，返回处理结果，返回值必须是json格式 Content-type: application/json
请求示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"activity_guid": "f2f219309b5c1a021fc019b3b557b9f8",
"h5_guid": "123456",
"openid": "gb_1543999047492",
"query_contacts": [
{"key":"姓名","value":"张三"},
{"key":"学号","value":"9523"},
],
"field_list": ["学号","姓名","性别","语文","数学","英语"]
}
返回值示例， json格式 Content-type: application/json
{
"result": 0,
"data": [
{"key": "学号","value": ""},
{"key": "姓名","value": "张三"},
{"key": "性别","value": "男"},
{"key": "语文","value": "90分"},
{"key": "数学","value": "100分"},
{"key": "英语","value": "100分"}
],
"msg": "ok"
}
相关文档
