更新家长

POST

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

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

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

责任人：未设置

权限说明：学校需要使用“家校沟通”secret所获取的accesstoken来调用（accesstoken如何获取？）；第三方应用需拥有「家校沟通」使用和编辑权限。

文档ID: 19181
原文档地址：
https://open.work.weixin.qq.com/api/doc/90001/90143/92081
https://open.work.weixin.qq.com/api/doc/90000/90135/92333

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

parent_userid

string

必需

家长UserID。学校内必须唯一。不区分大小写，长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成，且第一个字符必须是数字或字母。

children

array [object {2}]

可选

家长的孩子列表，该字段是全量更新，如果孩子列表为空则忽略该字段，最多10个

student_userid

string

学生的UserID

必需

relation

string

必需

家长与学生的关系，最长32字节

mobile

string

家长手机号

可选

new_parent_userid

string

可选

更新的家长UserID。不能与已经存在的家长UserID相同。每个家长仅能更新一次。

示例

{
  "parent_userid": "zhangsan_parent_userid",
  "new_parent_userid": "NEW_ID",
  "mobile": "18000000000",
  "children": [
    {
      "student_userid": "zhangsan",
      "relation": "爸爸"
    },
    {
      "student_userid": "lisi",
      "relation": "伯父"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/school/user/update_parent?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parent_userid": "zhangsan_parent_userid",
    "new_parent_userid": "NEW_ID",
    "mobile": "18000000000",
    "children": [
        {
            "student_userid": "zhangsan",
            "relation": "爸爸"
        },
        {
            "student_userid": "lisi",
            "relation": "伯父"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "errmsg": "string"
}

修改于 2022-08-30 03:03:36

删除家长

批量创建家长