读取学生或家长

GET

http://127.0.0.1/cgi-bin/school/user/get

第三方应用开发/家校沟通/学生与家长管理

最后修改时间：2022-08-30 03:03:37

责任人：未设置

权限说明：学校需要使用“家校沟通”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）。第三方应用需拥有「家校沟通」使用权限。

文档ID: 18819
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92038
https://open.work.weixin.qq.com/api/doc/90000/90135/92337

请求参数

Query 参数

userid

string

必需

家校通讯录的userid，家长或者学生的userid。不区分大小写，长度为1~64个字节

示例值:

userid

access_token

string

调用接口凭证

必需

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request GET 'http://127.0.0.1/cgi-bin/school/user/get?userid=userid&access_token={{access_token}}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

parent

object

可选

学生家长，user_type为2时返回该字段

external_userid

string

可选

parent_userid

string

可选

children

array [object {2}]

可选

mobile

string

可选

is_subscribe

integer <int32>

可选

user_type

integer <int32>

可选

用户类型:1表示学生，2表示家长

student

object

可选

学生字段，user_type为1时返回该字段

student_userid

string

可选

name

string

可选

department

array[integer <int32>]

可选

parents

array [object {4}]

可选

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "parent": {
    "external_userid": "string",
    "parent_userid": "string",
    "children": [
      {
        "student_userid": "string",
        "relation": "string"
      }
    ],
    "mobile": "string",
    "is_subscribe": 0
  },
  "user_type": 0,
  "student": {
    "student_userid": "string",
    "name": "string",
    "department": [
      0
    ],
    "parents": [
      {
        "parent_userid": "string",
        "mobile": "string",
        "is_subscribe": 0,
        "relation": "string"
      }
    ]
  },
  "errmsg": "string"
}

批量更新家长

获取部门成员详情