服务端API



获取部门列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/oa/department/list
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
parent_id String 是 部门上级ID，一级部门该值为1
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，默认100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "dept_id": "xxxx",
                "parent_id": "xxxx",
                "dept_name": "xxxx",
                "company_id": "xxxx"
            },
            {
                "dept_id": "xxxx",
                "parent_id": "xxxx",
                "dept_name": "xxxx",
                "company_id": "xxxx"
            }
        ],
        "has_more": 0
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的数据部门列表
dept_id String 部门ID，同company_id组织内唯一，最大长度36字符
parent_id String 部门上级ID，一级部门该值为1，最大长度36字符
dept_name String 部门名称，最大长度64字符
company_id String 所属企业ID，最大长度64字符
has_more Int 是否还有数据没返回：
1 还有
0 没有



获取部门详情

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/oa/department/info
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
dept_id String 是 部门ID

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "dept_id": "XXXX",
        "parent_id": "XXXX",
        "dept_name": "XXXX",
        "company_id": "XXXX"
    }
}

参数说明：

参数 类型 说明
data> Array 返回的数据包
dept_id String 部门ID，同company_id组织内唯一，最大长度36字符
parent_id String 部门上级ID，一级部门该值为1，最大长度36字符
dept_name String 部门名称，最大长度64字符
company_id String 所属企业ID，最大长度64字符



获取用户列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/oa/departmentUser/list
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
dept_id String 是 需要获取用户的部门ID
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，默认100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "dept_user_id": "xxxx",
                "dept_user_name": "xxxx",
                "company_id": "xxxx"
            },
            {
                "dept_user_id": "xxxx",
                "dept_user_name": "xxxx",
                "company_id": "xxxx"
            }
        ],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
dept_user_id String 用户ID，同company_id组织内唯一，最大长度64字符
dept_user_name String 用姓名，最大长度100字符
company_id String 所属企业ID，最大长度64字符
has_more Int 是否还有数据没返回：
1 还有
0 没有



获取用户详情

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/oa/departmentUser/info
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
dept_user_id String 是 工号，用户在企业内唯一标识

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "dept_user_id": "XXXX",
        "dept_user_name": "XXXX",
        "avatar": "XXXX",
        "position": "XXXX",
        "dept_ids": [
            "XXXX"
        ],
        "company_id": "XXXX"
    }
}

参数说明：

参数 类型 说明
data> Array 返回的数据包
dept_user_id String 用户ID，同company_id组织内唯一，最大长度64字符
dept_user_name String 姓名，最大长度100字符
avatar String 头像，可为空字符串，最大长度255字符
position String 职位，最大长度50字符
dept_ids Array 该用户所属部门ID列表
company_id String 所属企业ID



获取讲师列表

请求方式：GET（HTTPS）
请求地址：https://oapi.soke.cn/lector/lector/list
Query参数说明：

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，最大100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "title": "测试讲师",
                "contact_information": "",
                "is_in": 1,
                "employer": "",
                "grade_title": "特级",
                "area": [],
                "experience": [],
                "lector_score": "0.00",
                "course_total_score": "0.00",
                "course_learn_num": 0,
                "course_score": "0.00",
                "training_total_score": "0.00",
                "training_learn_num": 0,
                "training_score": "0.00",
                "course_num": 1,
                "training_num": 4,
                "exam_num": 0,
                "live_num": 0,
                "dept_user_id": "010651454937714422",
                "lector_id": "1D61ADE0-0701-4EFB-876A-6A49319A8114",
                "pc_url": "https://saas.eduto.com/pcHome/dist/ssoLogin?appid=8C3725A4-1A20-41F4-B601-778E33B51DFF&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=LecturerDetail&uuid=1D61ADE0-0701-4EFB-876A-6A49319A8114",
                "mobile_url": "https://saas.eduto.com/mobile/dist/ssoLogin?appid=8C3725A4-1A20-41F4-B601-778E33B51DFF&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=lecturerLearn&uuid=1D61ADE0-0701-4EFB-876A-6A49319A8114"
            }
        ],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
lector_id String 讲师ID，最大长度36字符
title String 讲师姓名，最大长度100字符
contact_information String 讲师联系方式，最大长度200字符
is_in Int 讲师来源：
0 外部
1 内部
employer String 讲师所在单位，最大长度200字符
grade_title String 讲师级别，最大长度100字符
area Array 讲师擅长领域，最大长度300字符
experience Array 讲师授课经历，最大长度65535字符
lector_score Decimal(3,2) 讲师评分
course_total_score Decimal(10,2) 线上课总评分
course_learn_num Int 线上课学习人数，最大位数10
course_score Decimal(3,2) 线上课平均分
training_total_score Decimal(10,2) 线下培训课总评分
training_learn_num Int 线下培训课学习人数，最大位数10
training_score Decimal(3,2) 线下培训课平均分，最大位数10
course_num Int 线上课数量，最大位数10
training_num Int 线下课数量，最大位数10
exam_num Int 考试数量，最大位数10
live_num Int 直播课数量，最大位数10
pc_url String pc端跳转链接
mobile_url String 移动端跳转链接
has_more Int 是否还有数据没返回：
1 还有
0 没有
获取凭证
用户组