获取学生健康信息 - Developer OpenAPI

权限说明：仅复学码应用可以调用

文档ID: 22014
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93745

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

date

string

必需

具体某天的健康信息，最久只能拉取当前时间起13天前的数据

next_key

string

可选

上一次调用时返回的next_key，初次调用可以不填

limit

integer <int32>

可选

每次拉取的数据量，默认值和最大值都为100

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

ending

integer <int32>

可选

是否结束。0：表示还有更多数据，需要继续拉取，1：表示已经拉取完所有数据

health_infos

array [object {4}]

可选

report_values

array [object {3}]

可选

该用户对自定义问题的答案列表，该列表每一项代表着针对一个问题的答案，当选答题用户未答的时候，该列表下将找不到对应的答案

self_submit

integer <int32>

可选

健康状态是否为本人填写。1：表示“是”，2：表示“否”

health_qrcode_status

integer <int32>

可选

健康码状态。1：表示正常，2：表示异常。从指定日期起过去14天内，如果任何一天健康状态异常，健康码状态也会被判断为异常

userid

string

可选

用户（老师）的userid

next_key

string

可选

当前数据最后一个key值，如果下次调用带上该值则从该key值往后拉，用于实现分页拉取

errmsg

string

可选

对返回码的文本描述内容

template_id

string

可选

该问题模版的id，可以通过该id判断问题是否有更新

question_templates

array [object {6}]

可选

is_not_display

integer <int32>

可选

该自定义问题是否隐藏，1：表示“是”，0：表示“否”

is_must_fill

integer <int32>

可选

该自定义问题是否必填，1：表示“是”，0：表示“否”

question_type

integer <int32>

可选

自定义问题的问题类型，1：表示是填空题，2：表示是单选题

title

string

可选

自定义问题的title

question_id

integer <int32>

可选

自定义问题的question_id

option_list

array [object {2}]

必需

自定义问题的选项列表，仅当该题为单选题时才有该字段

示例

{
  "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"
}