删除家长关系

DELETE

http://127.0.0.1/v1.0/edu/classes/{classId}/guardians/{userId}

服务端API/新教育/家校通讯录2.0/通讯录信息写入

最后修改时间：2022-08-30 09:19:24

责任人：未设置

说明

调用本接口删除与此家长关联的家长身份。
服务地址：api.dingtalk.com

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	教育行业扩展通讯录写权限	API Explorer
第三方企业应用	支持	教育行业扩展通讯录写权限	API Explorer
第三方个人应用	暂不支持	教育行业扩展通讯录写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	invalidParameter	PARAMETER INVALID	参数非法
400	illegalOrg	ILLEGAL ORG	未被组织授权
400	noRight	NO RIGHT	当前用户没有操作权限
500	systemBusy	SYSTEM BUSY	系统繁忙
500	deleteGuardianFail	DELETE GUARDIAN FAIL	删除家长失败

请求参数

Path 参数

classId

string

班级ID。

必需

userId

string

家长userid。

必需

Query 参数

stuId

string

学生userid。

必需

operator

string

必需

操作人userid。

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request DELETE 'http://127.0.0.1/v1.0/edu/classes//guardians/?stuId=&operator=' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

success

boolean

调用结果。

可选

示例

{
  "success": true
}

删除学生

删除家校部门

删除家长关系

说明#

权限#

错误码#

请求参数

示例代码

返回响应

说明

权限

错误码