服务端API



获取培训班分类列表

请求方式:GET(HTTPS)
请求地址:https://oapi.soke.cn/learningMap/category/list
Query参数说明:

参数 类型 必须 说明
access_token String 是 应用access_token,2小时有效期
module Int 是 1是学习地图 2培训班
page Int 否 页码,默认从1开始
page_size Int 否 每页条数,最大100,默认100

返回结果:

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "uuid"  : "1D09EBF2-A8D9-4BDF-8D60-FADE743EBDS1",
                "title" : "分类标题1",
                "parent_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1501",
                "create_time": 1546565453000,
            },
          	{
                "uuid"  : "2E09EBF2-A8D9-4BDF-8D60-FADE743ETYR2",
                "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/learningMap/learningMap/list
Query参数说明:

参数 类型 必须 说明
access_token String 是 应用access_token,2小时有效期
module Int 是 1是学习地图 2培训班
start_time Int 是 培训班创建时间的查询起始时间,Unix时间戳,单位毫秒
end_time Int 是 培训班创建时间的查询结束时间,Unix时间戳,单位毫秒
注意:起始与结束时间差不超365天
certificate_id String 否 关联证书ID
status Int 否 培训班状态:
0 未发布
1 已发布
2 已关闭
page Int 否 页码,默认从1开始
page_size Int 否 每页条数,最大100,默认100

返回结果:

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "list": [
            {
                "uuid"  : "培训班唯一ID",
                "title" : "培训班标题",
                "category_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1508",
                "status" : 1,
                "certificate_id": "100619E7-5004-464D-A80A-D9D2DFA4F271",
                "description"  : "培训班攻略",
                "stage_number" : 1,
                "publish_time" : 1546565453000,
                "open_time"    : 1609957197000,
                "learning_num" : 1,
                "finish_num"   : 1,
                "count_meta"    : {
                    "course"  : 1,
                    "exam"    : 1,
                    "survey"  : 0,
                    "training": 0
                },
                "pc_url": "https://saas.eduto.com/pcHome/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94",
				"mobile_url": "https://saas.eduto.com/mobile/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94"
            },
          	{
                "uuid"  : "培训班唯一ID",
                "title" : "培训班标题",
                "category_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1508",
                "status" : 1,
                "certificate_id": "200619E7-5004-464D-A80A-D9D2DFA4F272",
                "description"  : "培训班攻略",
                "stage_number" : 1,
                "publish_time" : 1546565453000,
                "open_time"    : 1609957197000,
                "learning_num" : 1,
                "finish_num"   : 1,
                "count_meta"    : {
                    "course"  : 1,
                    "exam"    : 1,
                    "survey"  : 0,
                    "training": 0
                },
                "pc_url": "https://saas.eduto.com/pcHome/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94",
				"mobile_url": "https://saas.eduto.com/mobile/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94"
            }
        ],
        "has_more": 1
    }
}

参数说明:

参数 类型 说明
data Array 返回的数据包
list Array 返回的用户列表
uuid String 培训班ID,最大长度36字符
title String 培训班标题,最大长度255字符
category_id String 培训班分类ID,最大长度36字符
status Int 学习地图状态:
0 未发布
1 已发布
2 已关闭
certificate_id String 关联证书ID,最大长度36字符
description String 培训班攻略,最大长度65535字符
stage_number Int 培训班中设置的阶段数量,最大位数11
publish_time Int 培训班发布时间,Unix时间戳,单位毫秒
open_time Int 培训班设置的开启时间,Unix时间戳,单位毫秒,0为不限制
learning_num Int 学习人数,最大位数11
finish_num Int 完成人数,最大位数11
count_meta Array 培训班中各项内容的数量:
course :课程数量
exam   :考试数量
survey  :问卷数量
training:培训数量
pc_url String pc端跳转链接
mobile_url String 移动端跳转链接
create_time Int 创建时间,Unix时间戳,单位毫秒
has_more Int 是否还有数据没返回:
1 还有
0 没有



获取培训班详情

请求方式:GET(HTTPS)
请求地址:https://oapi.soke.cn/learningMap/learningMap/info
Query参数说明:

参数 类型 必须 说明
access_token String 是 应用access_token,2小时有效期
map_id String 是 培训班ID

返回结果:

{
    "code": "200",
    "status": "ok",
    "message": "success",
    "data": {
        "uuid"  : "培训班唯一ID",
        "title" : "培训班标题",
        "category_id": "1C09EBF2-A8D9-4BDF-8D60-FADE743E1508",
        "description"  : "培训班攻略",
        "pc_url": "https://saas.eduto.com/pcHome/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94",
		"mobile_url": "https://saas.eduto.com/mobile/dist/ssoLogin?appid=1D13B009-0482-4B80-B3C3-08CCE0C29E85&corpid=dingc4cffb655c00d67f35c2f4657eb6378f&gotoUrl=trainingCourse&uuid=3B71E903-8E57-46C5-B3AB-5A7B8A637F94"
    }
}

参数说明:

参数 类型 说明
data Array 返回的数据包
uuid String 培训班ID,最大长度36字符
title String 培训班标题,最大长度255字符
category_id String 培训班分类ID,最大长度36字符
description String 培训班攻略,最大长度65535字符
pc_url String pc端跳转地址
mobile_url String mobile端跳转地址