请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/school/user/get_teacher_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值往后拉,用于实现分页拉取 |