企业内部开发 服务端API 家校应用 健康上报 获取用户填写答案
获取用户填写答案
最后更新:2023/11/30
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取用户填写答案
最后更新:2023/11/30

目录

  • 获取用户填写答案
  • 获取用户填写答案

    通过此接口可以获取指定的健康上报任务详情。

    请求方式:POST(HTTPS
    请求地址:https://qyapi.weixin.qq.com/cgi-bin/health/get_report_answer?access_token=ACCESS_TOKEN

    请求包体:

    {
    	"jobid": "jobid1",
    	"date": "2020-03-27",
    	"offset": 0,
    	"limit": 100
    }

    参数说明:

    参数必须说明
    access_token调用接口凭证
    jobid任务ID
    date具体某天任务的填写答案,仅支持获取最近14天数据
    offset数据偏移量
    limit拉取的数据量,最大值100

     

    权限说明:
    调用的应用需要满足如下的权限:

    应用类型权限要求
    自建应用配置到「健康上报 - 可调用接口的应用」中
    代开发应用暂不支持
    第三方应用暂不支持

    注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

    返回结果:

    {
       "errcode": 0,
       "errmsg": "ok",
       "answers":[
    		{
    			"id_type": 1,
    			"userid": "userid2",
    			"report_time": 123456789,
    			"report_values": [
    				{
    					"question_id": 1,
    					"single_choice": 2
    				},
    				{
    					"question_id": 2,
    					"text": "广东省广州市"
    				},
    				{
    					"question_id": 3,
    					"multi_choice": [
    						1, 3
    					]
    				},
    				{
    					"question_id": 4,
    					"fileid": [
                            "XXXXXXX"
                        ]
    				}
    			]
    		},
    		{
    			"id_type": 2,
    			"student_userid": "student_userid1",
    			"parent_userid": "parent_userid1",
    			"report_time": 123456789,
    			"report_values":[
    				{
    					"question_id": 1,
    					"single_choice": 1
    				},
    				{
    					"question_id": 2,
    					"text": "广东省深圳市"
    				},
    				{
    					"question_id": 3,
    					"multi_choice":[
    						1,2,3
    					]
    				},
    				{
    					"question_id": 4,
    					"fileid": [
                            "XXXXXXX"
                        ]
    				}
    			]
    		}
    	]
    }

    参数说明:

    参数说明
    errcode返回码
    errmsg对返回码的文本描述内容
    answers答案列表
    creator发起人的userid
    answers.id_typeid类型:1:表示返回企业内部成员的userid,2:表示返回的是家长和学生的userid
    answers.userid企业内部成员的userid,id_type=1时返回
    answers.student_userid学生的userid,id_type=2时返回
    answers.parent_userid家长的userid,id_type=2时返回
    answers.report_time用户填写时的时间戳
    answers.report_values用户填写的答案列表
    answers.report_values.question_id问题的id
    answers.report_values.single_choice单选题答案编号
    answers.report_values.text填空题答案内容
    answers.report_values.multi_choice多选题答案编号
    answers.report_values.fileid文件id,可以用下载文件接口下载
    answers.report_values.url签名的url,目前仅签名类型的问题会返回该字段
    answers.report_values.itinerary_card_type行程卡类型,仅行程卡类型的问题会返回该字段,0:行程码状态识别失败、1:绿码、2:红码、3:黄码、4:橙码、5:未识别出行程卡
    answers.report_values.high_risk_area高风险行程信息,仅行程卡类型的问题会返回该字段
    上一篇
    获取健康上报任务详情
    下一篇
    获取老师健康信息