dingtalk.oapi.edu.course.list (获取课程列表)

获取课程列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
op_userid String 必须 manager 当前操作人的用户ID
cursor Number 必须 0
  • 最小值:0
  • 表示分页游标,从0开始
    size Number 必须 10
  • 最小值:1
  • 最大值:100
  • 表示分页大小
    start_time Number 可选 1618294458 时间查询开始区间
    end_time Number 可选 1618396458 时间查询结束区间
    statuses Number [] 可选 0,1
  • 最大列表长度:5
  • 课程状态值
    option QueryCourseOption 可选 查询选项
    • └ b_fetch_classrooms
    • Boolean
    • 可选
    • false
    • 默认值:false
    • 是否连带查询课堂信息
    scene String 可选 lecture
  • 默认值:manage
  • 查询的场景:当前有:manage(管理视角),lecture(授课视角)
    participant_condition QueryCourseParticipantCondition 可选 参与方查询条件
    • └ role
    • String
    • 可选
    • teacher
    • 参与方角色选项
    suite_keys String [] 可选 [suitejc7o7gseko92digf,suitejc7o7gseko92digf2]
  • 最大列表长度:5
  • 按应用唯一标识列表查询
    course_codes String [] 可选 [EKKKe4580002,EKKKe4580003]
  • 最大列表长度:100
  • 按课程编码列表查询
    name String 可选 测试课程 按课程名称查询
    teacher_conditions QueryTeacherCondition [] 可选
  • 最大列表长度:30
  • 授课老师查询条件
    • └ corpid
    • String
    • 可选
    • ding4220d8e5128d0edd
    • 授课老师组织CorpId
    • └ userid
    • String
    • 可选
    • teacher1
    • 老师用户id

    响应参数

    名称 类型 示例值 描述
    success Boolean true 请求是否成功
    errcode Number 0 错误编码
    errmsg String error 错误信息
    result ListCourseResponse result
    • └ has_more
    • Boolean
    • ture
    • 是否还有更多数据
    • list
    • CourseVO []
    • list
    • └ biz_key
    • String
    • uk_1
    • 业务唯一键
    • └ teacher_userid
    • String
    • teacher1
    • 老师的用户ID
    • └ teacher_corpid
    • String
    • ding4220d8e5128d0edd
    • 老的的组织CorpId
    • └ end_time
    • Number
    • 1596506200000
    • 结束时间,Unix毫秒时间戳
    • └ start_time
    • Number
    • 1596506100000
    • 开始时间,Unix毫秒时间戳
    • └ introduce
    • String
    • 课程介绍
    • 课程介绍
    • └ name
    • String
    • 课程名称
    • 课程名称
    • └ code
    • String
    • 12312
    • 课程编码
    • └ teacher_username
    • String
    • 小五
    • 老师的用户名
    • classrooms
    • Classrooms []
    • list
    • └ target_id
    • String
    • 5fsd4dd8db81a25a44200643
    • 课堂唯一标识id
    • └ interact_info
    • String
    • {'duration': '20:30', 'cover':'...'}
    • 课堂交互信息
    • └ platform
    • Number
    • 2
    • 新版在线课堂
    • └ ext_info
    • String
    • {‘onlineMode’:1, 'recordAvatar':true}
    • 课程扩展信息
    • └ status
    • Number
    • 1
    • 课程状态 -1取消,0未开始,1进行中,2已结束
    • └ creator_corpid
    • String
    • ding4220d8e5128d0edd
    • 创建者的组织CorpId
    • └ creator_userid
    • String
    • creator1
    • 创建者的用户ID
    • └ creator_username
    • String
    • 小六
    • 创建者的用户名
    • └ next_cursor
    • Number
    • 10
    • 表示下一次分页的游标,如果next_corsor为null或者has_more为false,表示没有更多的分页数据
    • └ total_count
    • Number
    • 100
    • 数量总计100

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/edu/course/list");
    OapiEduCourseListRequest req = new OapiEduCourseListRequest();
    req.setOpUserid("manager");
    req.setCursor(0L);
    req.setSize(10L);
    req.setStartTime(1618294458L);
    req.setEndTime(1618396458L);
    req.setStatuses("0,1");
    QueryCourseOption obj1 = new QueryCourseOption();
    obj1.setBFetchClassrooms(false);
    req.setOption(obj1);
    req.setScene("lecture");
    QueryCourseParticipantCondition obj2 = new QueryCourseParticipantCondition();
    obj2.setRole("teacher");
    req.setParticipantCondition(obj2);
    req.setSuiteKeys("suitejc7o7gseko92digf,suitejc7o7gseko92digf2");
    req.setCourseCodes("EKKKe4580002,EKKKe4580003");
    req.setName("测试课程");
    List<QueryTeacherCondition> list4 = new ArrayList<QueryTeacherCondition>();
    QueryTeacherCondition obj5 = new QueryTeacherCondition();
    list4.add(obj5);
    obj5.setCorpid("ding4220d8e5128d0edd");
    obj5.setUserid("teacher1");
    req.setTeacherConditions(list4);
    OapiEduCourseListResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "success":true,
        "errcode":0,
        "errmsg":"error",
        "result":{
            "has_more":ture,
            "list":[
                {
                        "biz_key":"uk_1",
                        "teacher_userid":"teacher1",
                        "teacher_corpid":"ding4220d8e5128d0edd",
                        "end_time":1596506200000,
                        "start_time":1596506100000,
                        "introduce":"课程介绍",
                        "name":"课程名称",
                        "code":"12312",
                        "teacher_username":"小五",
                        "classrooms":[
                            {
                                    "target_id":"5fsd4dd8db81a25a44200643",
                                    "interact_info":"{'duration': '20:30', 'cover':'...'}"
                            }
                        ],
                        "platform":2,
                        "ext_info":"{‘onlineMode’:1, 'recordAvatar':true}",
                        "status":1,
                        "creator_corpid":"ding4220d8e5128d0edd",
                        "creator_userid":"creator1",
                        "creator_username":"小六"
                }
            ],
            "next_cursor":10,
            "total_count":100
        }
    }

    异常示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部