接入说明
- 用于查询用户在当前活动的答题进展, 包括统计信息和具体答案提交进展
以上方式涉及业务侧帐号与公益帐号的转换,需要满足以下条件:
- 腾讯内部已开通帐号互转权限的业务(仅限微信或QQ帐号体系)
- 外部已开通帐号互转权限的业务(仅限QQ帐号体系)
- 已通过开放平台绑定用户帐号的业务(任意帐号体系,暂未支持)
接入方需要提供微信开放平台的AppID和负责人(用于申请互转权限时作为审批人),或者QQ互联的AppID,由公益侧提交互转权限的申请,微信/QQ审批通过后,才能使用。注意:如果是微信游戏,则需要通过微信帐号托管平台做接入,参考微信游戏帐号托管
接口使用签名方式,如何生成签名以及用户信息的传递参考接口调用凭证
调用接口
查询当日用户答题状态及进展
使用场景: 用于查询用户当日的答题状态及进展。用于1: 前端控制UI显示 2: 外部服务根据用户答题状态判断是否展示拉起答题组件
调用凭证: 应用签名
请求方式: POST(HTTPS)
请求地址: https://oapi.gongyi.qq.com/api/question_service/QueryUserActivityProfile
请求参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
package_id | string | 是 | 答题包ID |
- 请求示例
{ "package_id":"4" }
返回参数:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 0:成功 30140017:今日未答题 30140021: 抽题次数达到上限 |
has_passed | boolean | 是否已经通过: 全部题目都答对的情况 即为用过 |
has_received_flower | boolean | 是否已领花 |
total_attempt_count | int | 答题机会次数 0: 无限次答题 >0:#次答题 |
used_attempt_count | int | 已使用答题次数 |
questions | array | 问题列表: 已回答问题的返回值包含题目来源,正确答案以及答案解析 |
answers | int | 答案列表 |
返回示例:
{
"code": 0,
"msg": "",
"op_time": 1676275643,
"trace_id": "b862a0e05c73b1ace15bd0d8d9bcff5f",
"data": {
"current_paper_id": "oproJj6xqWnRYx3HYbWbrdIM07DI_4",
"has_passed": true,
"has_received_flower": true,
"total_attempt_count": 0,
"used_attempt_count": 1,
"answers": [
{
"answers": [
"B"
],
"question_id": "38"
},
{
"answers": [
"A"
],
"question_id": "32"
},
{
"answers": [
"A"
],
"question_id": "31"
}
],
"questions": [
{
"analysis": "频繁打开冰箱门",
"author": "",
"option_type": 1,
"options": [
{
"content": "将温度高于室温的食品放入冰箱",
"option_id": "A"
},
{
"content": "尽量减少开门次数",
"option_id": "B"
},
{
"content": "经常把插头拔掉",
"option_id": "C"
}
],
"order": 1,
"question_id": "38",
"right_answers": [
"B"
],
"source": "腾讯ssv碳中和实验室",
"title": "从低碳生活的角度,以下哪些是正确使用冰箱的做法?"
}
]
}
}