Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 通讯录信息写入
  • 通用基础
    • 学段
      • 获取学段元数据列表
    • 学科
      • 获取学科元数据列表
      • 创建学科实例
      • 更新学科实例
      • 删除学科实例
      • 获取学科实例详情
      • 获取学科实例列表
    • 查询教育组织类型
      GET
  • 在线课堂
    • 排课
      • 创建课程
      • 修改课程
      • 删除课程
      • 获取课程详情
      • 获取课程列表
      • 添加课程参与方
      • 获取课程参与方列表
      • 移除课程参与方
    • 授课
      • 开始课程
      • 加入课程
      • 结束课程
      • 回放课程
    • 课堂数据
      • 获取课堂概要数据
      • 获取课堂明细数据
  • 家校通讯录2.0
    • 通讯录信息读取
      • 获取部门详情
      • 获取部门列表
      • 获取人员列表
      • 获取人员详情
      • 获取人员关系列表
      • 获取人员关系详情
    • 通讯录信息写入
      • 添加老师
        POST
      • 添加家长
        POST
      • 学生调班
        POST
      • 添加学生
        POST
      • 创建学段
        POST
      • 初始化家校架构
        POST
      • 创建班级
        POST
      • 创建年级
        POST
      • 删除老师
        DELETE
      • 删除学生
        DELETE
      • 删除家长关系
        DELETE
      • 删除家校部门
        DELETE
      • 创建自定义部门下的班级
        POST
      • 创建自定义校区或部门
        POST
    • 获取学生信息
      • 获取学生信息
      • 获取学生ID列表
  • 家庭
    • 家庭Feed同步
      POST
    • 查询家庭孩子信息
      POST
    • 学习推荐数据回流
      POST
    • 静态推荐数据同步
      POST
  • 班级圈
    • 获取班级圈话题列表
    • 获取班级圈动态列表
  • 数字化证书
    • 获取数字化证书
  1. 通讯录信息写入

删除学生

DELETE
http://127.0.0.1/v1.0/edu/classes/{classId}/students/{userId}
服务端API/新教育/家校通讯录2.0/通讯录信息写入
最后修改时间:2022-08-30 09:19:24
责任人:未设置

说明#

调用本接口删除学生。
服务地址:api.dingtalk.com

权限#

要调用此API,需要以下权限之一。
应用类型是否支持权限API Explorer调试
企业内部应用支持教育行业扩展通讯录写权限API Explorer
第三方企业应用支持教育行业扩展通讯录写权限API Explorer
第三方个人应用暂不支持教育行业扩展通讯录写权限暂不支持

错误码#

HttpCode错误码错误信息说明
400invalidParameterPARAMETER INVALID参数非法
400illegalOrgILLEGAL ORG未被组织授权
400noRightNO RIGHT当前用户没有操作权限
500systemBusySYSTEM BUSY系统繁忙
500deleteStudentFailDELETE_STUDENT_FAIL删除学生失败

请求参数

Path 参数
classId
string 
班级ID。
必需
userId
string 
必需
学生的userid。
Query 参数
operator
string 
必需
操作人userid。
Header 参数
x-acs-dingtalk-access-token
string 
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'http://127.0.0.1/v1.0/edu/classes//students/?operator=' \
--header 'x-acs-dingtalk-access-token;' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
success
boolean 
调用结果。
可选
示例
{
  "success": true
}
上一页
删除老师
下一页
删除家长关系
Built with