dingtalk.oapi.edu.course.create (创建课程)

创建课程

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
op_userid String 必须 manager1 当前用户ID
teacher_corpid String 必须 ding4220d8e5128d0edd 老师的组织CorpId
teacher_userid String 必须 teacher1 老师的用户ID
introduce String 必须 我是课程介绍
  • 最大长度:120
  • 课程介绍
    biz_key String 必须 uk_1
  • 最大长度:64
  • 业务唯一键,用于保证课程的唯一性,防止重复创建
    name String 必须 我是课程名称
  • 最大长度:64
  • 课程名称
    start_time Number 可选 1596506100000 课程的开始时间,Unix毫秒时间戳
    end_time Number 可选 1596506200000 课程的结束时间,Unix毫秒时间戳
    option CreateCourseOption 可选 课程选项信息
    • └ platform
    • String
    • 可选
    • 1
    • 使用的平台:1(在线课堂)、2(在线课堂Pro)
    • └ recordAvatar
    • Boolean
    • 可选
    • false
    • 是否录制老师头像
    • └ onlineMode
    • String
    • 可选
    • 1
    • 课堂模式:1/6/12(支持多少人上台)

    响应参数

    名称 类型 示例值 描述
    course_code String GJKI49001 课程唯一编码
    success Boolean true 请求是否成功
    errcode Number 0 dingOpenErrcode
    errmsg String 成功 errorMsg

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/course/create");
    OapiEduCourseCreateRequest req = new OapiEduCourseCreateRequest();
    req.setOpUserid("manager1");
    req.setTeacherCorpid("ding4220d8e5128d0edd");
    req.setTeacherUserid("teacher1");
    req.setIntroduce("我是课程介绍");
    req.setBizKey("uk_1");
    req.setName("我是课程名称");
    req.setStartTime(1596506100000L);
    req.setEndTime(1596506200000L);
    CreateCourseOption obj1 = new CreateCourseOption();
    obj1.setPlatform("1");
    obj1.setRecordAvatar(false);
    obj1.setOnlineMode("1");
    req.setOption(obj1);
    OapiEduCourseCreateResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "course_code":"GJKI49001",
        "success":true,
        "errcode":0,
        "errmsg":"成功"
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部