创建年级

POST

/topapi/edu/grade/create

调用本接口，创建年级。

调用本接口，可创建年级，接口调用效果与下图操作实现效果一致。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	钉钉教育家校通讯录写权限	调试
第三方企业应用	是	钉钉教育家校通讯录写权限	调试
第三方个人应用	否	—	—

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/edu/grade/create?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "super_id": 4240018,
    "operator": "user01",
    "open_grade": {
        "grade": "2",
        "classes": 1,
        "name": "二年级2019级",
        "start_year": "2019"
    }
}'

响应示例

{
    "errcode": 0,
    "result": {
        "dept_id": 4240018
    },
    "success": true,
    "request_id": "5bsof0hsgtds"
}

修改于 2024-01-23 03:46:21

删除家校部门

创建班级

创建年级

权限#

请求参数

返回响应

权限