企业内部开发 服务端API 家校应用 复学码 获取学生健康信息
获取学生健康信息

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

请求包体:

{
	"date": "2020-03-27",
	"next_key": "NEXT_KEY",
	"limit": 100
}

参数说明:

参数必须说明
access_token调用接口凭证。
date具体某天的健康信息,最久只能拉取当前时间起13天前的数据
next_key上一次调用时返回的next_key,初次调用可以不填
limit每次拉取的数据量,默认值和最大值都为100

权限说明:

  • 仅复学码应用可以调用

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "health_infos":[
		{
			"userid": "zhangsan",
			"health_qrcode_status": 1,
			"self_submit": 2,
            "report_values": [
                {
                    "question_id": 1,
                    "single_chose": 1
                },
                {
                    "question_id": 2,
                    "text": "浑身难受"
                }
            ]
		},
		{
			"userid": "lisi",
			"health_qrcode_status": 2,
			"self_submit": 1,
            "report_values": [
                {
                    "question_id": 1,
                    "single_chose": 2
                }
            ]
		}
   ],
   "question_templates":[
        {
            "question_id": 1,
            "title": "请问你有任何身体不适吗?",
            "question_type": 2,
            "is_must_fill": 1,
            "is_not_display": 2,
            "option_list": [
                {
                    "option_id": 1,
                    "option_text": "有"
                },
                {
                    "option_id": 2,
                    "option_text": "没有"
                }
            ]
        },
        {
            "question_id": 2,
            "title": "具体哪里不适?(第一题为没有的可以不答)",
            "question_type": 1,
            "is_must_fill": 2,
            "is_not_display": 2
        }
   ],
   "template_id": "XXXXXXXXXXXXXXXXX"
   "ending": 1,
   "next_key": "NEXT_KEY"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
health_infos.userid用户(学生)的userid
health_infos.health_qrcode_status健康码状态。1:表示正常,2:表示异常。从指定日期起过去14天内,如果任何一天健康状态异常,健康码状态也会被判断为异常
health_infos.self_submit健康状态是否为本人填写。1:表示“是”,2:表示“否”
health_infos.report_values该用户对自定义问题的答案列表,该列表每一项代表着针对一个问题的答案,当选答题用户未答的时候,该列表下将找不到对应的答案
health_infos.report_values.question_id自定义问题的question_id,代表了这一项是哪个问题的答案
health_infos.report_values.single_chose自定义问题的选项答案,代表了用户这个问题选了哪个选项,仅当该题为单选题时才有该字段
health_infos.report_values.text自定义问题的填空答案,代表了用户这个填空题的答案,仅当该题为填空题时才有该字段
question_templates.question_id自定义问题的question_id
question_templates.title自定义问题的title
question_templates.question_type自定义问题的问题类型,1:表示是填空题,2:表示是单选题
question_templates.is_must_fill该自定义问题是否必填,1:表示“是”,0:表示“否”
question_templates.is_not_display该自定义问题是否隐藏,1:表示“是”,0:表示“否”
question_templates.option_list自定义问题的选项列表,仅当该题为单选题时才有该字段
question_templates.option_list.option_id该选项的option_id
question_templates.option_list.option_text该选项的文案说明
template_id该问题模版的id,可以通过该id判断问题是否有更新
ending是否结束。0:表示还有更多数据,需要继续拉取,1:表示已经拉取完所有数据
next_key当前数据最后一个key值,如果下次调用带上该值则从该key值往后拉,用于实现分页拉取
上一篇
获取老师健康信息
下一篇
获取师生健康码