服务端API



获取证书分类列表

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

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

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "uuid"  : "分类唯一ID1",
                "title" : "分类标题1",
                "parent_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1501",
                "create_time": 1546565453000,
            },
          	{
                "uuid"  : "分类唯一ID2",
                "title" : "分类标题2",
                "parent_id": "2C09EBF2-A8D9-4BDF-8D60-FADE743E1502",
                "create_time": 1546565453000,
            }
        ],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的列表
uuid String 分类唯一ID，最大长度36字符
title String 分类标题，最大长度64字符
parent_id String 分类父ID，最大长度36字符
create_time String 创建时间，Unix时间戳，单位毫秒
has_more Int 是否还有数据没返回：
- 1 还有
- 0 没有



获取证书列表

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

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
start_time Int 是 查询证书列表的起始时间，Unix时间戳，单位毫秒
end_time Int 是 查询证书列表的结束时间，Unix时间戳，单位毫秒
注意：起始与结束时间差不超365天
status Int 否 证书状态：
0 未发布
1 发布
2 关闭
-1 删除
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，默认100

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [{
   		   "uuid": "938D8258-BC89-473E-9C16-AF88A7D99B48",
           "title": "速度",
           "status": 1,
           "code": "12234324",
           "image": "https://cdndinglearning.eduto.com/cert/image/Wt76mRZy8w1603173486518.png",
		   "category_id": "76630067-8363-42CB-90EA-386D820F5F1A",
           "description": "生日",
           "create_time": 1609957197000
    		}],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的列表
uuid String 证书唯一ID，最大长度36字符
category_id String 证书分类ID，最大长度36字符
title String 标题，最大长度64字符
status Int 证书状态：
0 未发布
1 发布
2 关闭
-1 删除
code String 证书编码，最大长度64字符
image String 证书图片，最大长度255字符
description String 证书描述，最大长度65535字符
create_time Int 创建时间，Unix时间戳，单位毫秒
has_more Int 是否还有数据没返回：
1 还有
0 没有



获取证书用户列表

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

参数 类型 必须 说明
access_token String 是 应用access_token，2小时有效期
target_id String 是 来源uuid（考试，课程，线下培训，学习地图的uuid）
userid_list String 否 员工在企业内的UserID列表，多个UserId用英文逗号隔开，一次最多100个
start_time Int 否 学员获得证书的时间，Unix时间戳，单位毫秒
注意：开始时间与当前时间差不能大于365天
end_time Int 否 学员获得证书的时间，Unix时间戳，单位毫秒
注意：起始与结束时间差不超7天
update_start_time Int 否 学员证书更新的时间，Unix时间戳，单位毫秒
注意：开始时间与当前时间差不能大于365天
update_end_time Int 否 学员证书更新的时间，Unix时间戳，单位毫秒
注意：起始与结束时间差不超7天
page Int 否 页码，默认从1开始
page_size Int 否 每页条数，最大100，默认100

Query参数提示： userid_list参数与start_time、end_time时间参数与update_start_time、update_end_time时间参数三选一，不能同时不传。

返回结果：

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [{
      		 "dept_user_id": "123456",
      		 "certificate_id": "7EA61028-CDCD-4F1F-B475-644010863480",
      		 "certificate_title": "dfsfds",
      		 "certificate_num": "000002",
      		 "certificate_image": "https://sssssss.png",
      		 "module": "exam",
      		 "status": 1,
      		 "target_id": "E45E1214-C1C5-4FE2-84F6-BA07A2193276",
      		 "target_title": "企业文化必修课",
      		 "create_time": 1546565453000,
           "update_time": 1609957197000
    		}],
        "has_more": 1
    }
}

参数说明：

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
dept_user_id String 用户ID，最大长度64字符
certificate_id String 证书uuid，最大长度36字符
certificate_title String 证书标题，最大长度64字符
certificate_num String 证书编号，最大长度64字符
certificate_image String 证书图片URL，最大长度255字符
module string 获得证书来源：
exam 考试
course 课程
learningmap 学习地图
training 线下培训
training_class 项目培训班
award 颁发证书
status Int 发布状态：
0 取消证书
1 颁布证书
2 重新授予证书
target_id String 来源uuid，最大长度36字符
target_title String 来源标题，最大长度255字符
create_time Int 创建时间，Unix时间戳，单位毫秒
update_time Int 更新时间，Unix时间戳，单位毫秒
has_more Int 是否还有数据没返回：
1 还有
0 没有
考试
学分