腾讯乐享接口文档 # 项目
# 已发布项目列表
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps
# 参数说明：
支持分页参数和排序：（通用说明？）
支持时间范围过滤
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| sort | 否 | created_at | 排序参数，支持按学习地图的created_at排序 |
| team_id | 否 | 无 | K吧id |
| plan_id | 否 | 无 | 培训计划id； 设置此值后只返回与该培训计划关联的项目 |
# SDK封装方法使用示例：
$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('roadmaps');
# 响应document
# 200 OK 状态码
{
"data": [
{
"type": "roadmap",
"id": "5964",
"attributes": {
"title": "培训班",
"checkpoint_count": 1,
"content": "<p>111</p>",
"created_at": "2024-05-30 19:24:12",
"cover": "",
"subject_type": "training",
"status": 1,
"to_staff_count": 0,
"passed_staff_count": 0
},
"links": {
"platform": "https://km.lexiangla.com/learning/5964/list"
},
"relationships": {
"category": {
"data": {
"type": "category",
"id": "86579fb0830211eb8e4ed62729524115"
}
},
"plan": {
"data": {
"type": "plan",
"id": "fdfe8b48870611f0b6b90242c0a8c012"
}
}
}
},
{
"type": "roadmap",
"id": "5963",
"attributes": {
"title": "学习地图",
"checkpoint_count": 1,
"content": "<p>111</p>",
"created_at": "2024-05-30 17:09:56",
"cover": "",
"subject_type": "learning",
"status": 1,
"to_staff_count": 33190,
"passed_staff_count": 0
},
"links": {
"platform": "https://km.lexiangla.com/learning/5963/list"
},
"relationships": {
"category": {
"data": {
"type": "category",
"id": "30d984a486d111ebbaf14a7697629675"
}
}
}
}
],
"links": {
"first": "https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps?per_page=2&page=1",
"last": "https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps?per_page=2&page=1975",
"prev": null,
"next": "https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps?per_page=2&page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1975,
"path": "https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps",
"per_page": 2,
"to": 2,
"total": 3950
},
"included": [
{
"type": "category",
"id": "86579fb0830211eb8e4ed62729524115",
"attributes": {
"name": "分类1",
"weight": 0
}
},
{
"type": "category",
"id": "30d984a486d111ebbaf14a7697629675",
"attributes": {
"name": "分类2",
"weight": -600
}
}, {
"type": "plan",
"id": "fdfe8b48870611f0b6b90242c0a8c012",
"attributes": {
"title": "测试培训计划",
"plan_type": "annual",
"plan_year": "2020",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 3,
"started_at": "2025-09-01 15:40:00",
"ended_at": "2025-09-11 15:40:00",
"total_budget": "111.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 100,
"roadmap_count": 1,
"attend_count": 1,
"attendees": "所有人",
"description": "11212121",
"created_at": "2025-09-01 15:40:54",
"updated_at": "2025-09-04 12:21:41"
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.attributes.title | 项目主题 |
| data.attributes.checkpoint_count | 任务数 |
| data.attributes.content | 介绍详情 |
| data.attributes.cover | 封面链接 |
| data.attributes.subject_type | 类型：learning（学习地图），training（培训班） |
| data.attributes.to_staff_count | 应完成人数 |
| data.attributes.passed_staff_count | 已完成人数 |
| data.attributes.created_at | 创建时间 |
| data.attributes.status | 项目状态；1：进行中，2：已结项 |
| data.links | 项目链接 |
| data.relationships.category | 关联的项目分类实体id |
# 获取单个项目信息
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps/{roadmap_id}
# 参数说明：
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| roadmap_id | 是 | 无 | 项目id |
# 响应document
# 200 OK 状态码
{
"data": {
"type": "roadmap",
"id": "2892",
"attributes": {
"title": "项目",
"checkpoint_count": 2,
"content": "",
"created_at": "2022-08-18 09:44:27",
"cover": "https://xxx.lexiangla.com/assets/41d599461e9711eda4f2befdeb73193e",
"subject_type": "learning",
"status": 1,
"point_plus": 1
},
"links": {
"platform": "https://km.lexiangla.com/learning/2892/list"
},
"relationships": {
"credit_rule": {
"data": {
"type": "credit_rule",
"id": 139066293
}
},
"category": {
"data": {
"type": "category",
"id": "30d984a486d111ebbaf14a7697629675"
}
},
"owner": {
"data": {
"type": "staff",
"id": "zhangsan"
}
},
"managers": {
"data": [
{
"type": "staff",
"id": "lisi"
}
]
},
"certificates": {
"data": [
{
"type": "certificate",
"id": 387
}
]
}
}
},
"included": [
{
"type": "credit_rule",
"id": 139066293,
"attributes": {
"rule_name": "roadmap_finish",
"credit": 100
}
},
{
"type": "category",
"id": "30d984a486d111ebbaf14a7697629675",
"attributes": {
"name": "分类",
"weight": -1
}
},
{
"type": "staff",
"id": "zhangsan",
"attributes": {
"name": "zhangsan",
"english_name": null
}
},
{
"type": "staff",
"id": "jessie",
"attributes": {
"name": "lisi",
"english_name": null,
"organization": "1 "
}
},
{
"type": "certificate",
"id": 387,
"attributes": {
"title": "新证书",
"code_fixed": "gg",
"code_weight": 5,
"total_num": 3,
"period": 0,
"created_at": "2022-08-08 10:09:42",
"updated_at": "2022-08-15 10:04:22",
"preview": "https://xxx.lexiangla.com/assets/90fac7e01c3e11ed9658a21b4ed08376",
"valid_num": "3"
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.attributes.title | 项目主题 |
| data.attributes.checkpoint_count | 任务数 |
| data.attributes.content | 项目介绍 |
| data.attributes.created_at | 创建时间 |
| data.attributes.cover | 封面链接 |
| data.attributes.subject_type | 类型：learning（学习地图），training（培训班） |
| data.attributes.status | 项目状态：0:草稿，1:进行中，2:已结项 |
| data.links | 项目链接 |
| data.attributes.point_plus | 额外积分 |
| data.relationships.owner | 创建人 |
| data.relationships.category | 项目分类 |
| data.relationships.managers | 项目负责人 |
| data.relationships.certificates | 项目证书，如果创建/编辑页关闭证书开关，则不返回 |
| data.relationships.credit_rule | 项目学分，如果创建/编辑页关闭学分开关，则不返回 |
| data.included.credit_rule.attributes.credit | 学分奖励的100倍数，需除以100后得到完成项目可获的学分奖励 |
# 获取单个项目关卡信息
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/roadmaps/{roadmap_id}/checkpoints
# 参数说明：
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| roadmap_id | 是 | 无 | 项目id |
# 响应document
# 200 OK 状态码
{
"data": [
{
"type": "checkpoint",
"id": 22952,
"attributes": {
"title": "项目课程",
"sequence": 1,
"is_from_assistant": 0
},
"relationships": {
"target": {
"data": {
"type": "clazz",
"id": "f5ee2b5af87a11ee9cb0fa108558f26f"
}
}
}
},
{
"type": "checkpoint",
"id": 22953,
"attributes": {
"title": "项目考试",
"sequence": 2,
"is_from_assistant": 0
},
"relationships": {
"target": {
"data": {
"type": "exam",
"id": "084b2d8ef87b11ee8c66fa108558f26f"
}
}
}
},
{
"type": "checkpoint",
"id": 22954,
"attributes": {
"title": "项目作业",
"sequence": 3,
"is_from_assistant": 0
},
"relationships": {
"target": {
"data": {
"type": "assignment",
"id": "212b9e1af87b11eeb413fa108558f26f"
}
}
}
},
{
"type": "checkpoint",
"id": 22955,
"attributes": {
"title": "项目问卷",
"sequence": 4,
"is_from_assistant": 0
},
"relationships": {
"target": {
"data": {
"type": "survey",
"id": "39065f02f87b11ee9b32fa108558f26f"
}
}
}
},
{
"type": "checkpoint",
"id": 22956,
"attributes": {
"title": "项目链接任务",
"sequence": 5,
"is_from_assistant": 0
},
"relationships": {
"target": {
"data": {
"type": "hyper_link",
"id": "4a266a7af87b11ee847dfa108558f26f"
}
}
}
}
],
"included": [
{
"type": "clazz",
"id": "f5ee2b5af87a11ee9cb0fa108558f26f",
"attributes": {
"type": 1,
"course_count": 1,
"title": "项目课程",
"description": "<p>课程</p>",
"cover_img": "",
"is_required": 0,
"privilege_type": 1,
"comment_count": 0,
"created_at": "2024-04-12 11:15:49",
"updated_at": "2024-04-12 11:15:49",
"recommended_at": null,
"participants_count": 0,
"app_source_type": "roadmap"
},
"links": {
"platform": "https://km.lexiangla.com/classes/f5ee2b5af87a11ee9cb0fa108558f26f?type=1",
"manager": "https://km.lexiangla.com/classes/f5ee2b5af87a11ee9cb0fa108558f26f/settings?map=5622&type=1"
}
},
{
"type": "exam",
"id": "084b2d8ef87b11ee8c66fa108558f26f",
"attributes": {
"title": "项目考试",
"content": "",
"staff_count": 38,
"privilege_type": 1,
"pass_score": null,
"duration": null,
"finished_privilege": 2,
"ended_privilege": 3,
"exam_times_limit": 1,
"limit_switch_count": 0,
"enable_face_recognition": 0,
"is_shuffled": 0,
"started_at": "2024-04-12 11:16:19",
"ended_at": "2034-04-12 11:16:19",
"tips_when_start": 0,
"tips_before_start": 0,
"tips_before_end": 0,
"created_at": "2024-04-12 11:16:19",
"updated_at": "2024-04-12 11:18:45",
"status": "running",
"staffs_count": 38,
"app_source_type": "roadmap"
},
"links": {
"platform": "https://km.lexiangla.com/exams/084b2d8ef87b11ee8c66fa108558f26f"
}
},
{
"type": "assignment",
"id": "212b9e1af87b11eeb413fa108558f26f",
"attributes": {
"title": "项目作业",
"content": "",
"summary": "",
"finished_type": 0,
"evaluation_method": 1,
"enable_required_comment": 0,
"total_score": 100,
"passing_score": 60
}
},
{
"type": "survey",
"id": "39065f02f87b11ee9b32fa108558f26f",
"attributes": {
"title": "项目问卷",
"summary": "",
"ended_at": null,
"privilege_type": 1,
"read_count": 0,
"comment_count": 0,
"participant_count": 0,
"type": "election",
"created_at": "2024-04-12 11:17:41"
},
"links": {
"platform": "https://km.lexiangla.com/surveys/39065f02f87b11ee9b32fa108558f26f"
}
},
{
"type": "hyper_link",
"id": "4a266a7af87b11ee847dfa108558f26f",
"attributes": {
"title": "项目链接任务",
"link": "https://lexiangla.com"
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| type | 类型为关卡 |
| data.attributes.title | 关卡名称 |
| data.attributes.sequence | 项目关卡顺序 |
| data.attributes.is_from_assistant | 是否来自带教布置的任务，0：否，项目自身的关卡；1：是 |
| data.relationships | 关联项目关卡的实体对象，包含课程，考试，活动，投票（问卷），作业，链接。 |
# 成员项目学习记录
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/staffs/{staff_id}/roadmaps
# 参数说明：
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| staff_id | 是 | 无 | 员工帐号 |
| status | 否 | 无 | 学习记录的状态 0：未开始，1：通关中，2：已通关，3：通关失败 |
# SDK封装方法使用示例：
$Lxapi = new \Lexiangla\Openapi\Api(AppKey, AppSecret);
$response = $Lxapi->get('staffs/ThreeZhang/roadmaps');
# 响应document
# 200 OK 状态码
{
"data": [
{
"type": "roadmap",
"id": "9",
"attributes": {
"title": "学习地图-经典列表",
"status": 0,
"started_at": null,
"ended_at": null
},
"links": {
"platform": "https://km.lexiangla.com/learning/9/list"
},
"relationships": {
"category": {
"data": {
"type": "category",
"id": "74787a20823b11eb8461668bec216377"
}
}
}
},
{
"type": "roadmap",
"id": "11",
"attributes": {
"title": "学习地图-游戏地图",
"status": 0,
"started_at": null,
"ended_at": null
},
"links": {
"platform": "https://km.lexiangla.com/learning/11/game"
},
"relationships": {
"category": {
"data": {
"type": "category",
"id": "74787a20823b11eb8461668bec216377"
}
}
}
},
{
"type": "roadmap",
"id": "6014",
"attributes": {
"title": "培训班-list-学习",
"status": 1,
"started_at": "2024-06-03 14:45:20",
"ended_at": null
},
"links": {
"platform": "https://km.lexiangla.com/learning/6014/list"
},
"relationships": {
"category": {
"data": {
"type": "category",
"id": "74787a20823b11eb8461668bec216377"
}
}
}
}
],
"included": [
{
"type": "category",
"id": "74787a20823b11eb8461668bec216377",
"attributes": {
"name": "其他",
"weight": 0
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.type | 资源对象类型，必须为roadmap，表示项目 |
| data.id | 学习地图的id |
| data.attributes.title | 学习地图的主题 |
| data.attributes.started_at | 学习的开始时间 |
| data.attributes.ended_at | 学习的结束时间 |
| data.attributes.status | 学习记录的状态。0：未开始，1：通关中，2：已通关，3：通关失败 |
| data.links | 项目链接 |
| data.relationships.category | 分类 |
# 成员单个项目学习记录
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/staffs/{staff_id}/roadmaps/{roadmap_id}
# 参数说明：
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| staff_id | 是 | 无 | 员工帐号 |
| roadmap_id | 是 | 无 | 项目id |
# 响应document
# 200 OK 状态码
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.attributes.title | 项目主题 |
| data.attributes.checkpoint_count | 关卡数量 |
| data.attributes.content | 项目介绍 |
| data.attributes.created_at | 创建时间 |
| data.attributes.cover | 封面 |
| data.attributes.subject_type | 类型：learning（学习地图），training（培训班 |
| data.attributes.status | 项目状态；1：进行中，2：已结项 |
| data.attributes.total_duration | 课程关卡完成条件时间总和（单位：s） |
| data.attributes.left_duration | 剩余完成课程关卡所需时间总和（单位：s） |
| data.attributes.ended_at | 项目结束时间 |
| data.links | 项目链接 |
| data.relationships.checkpoint | 关联的关卡信息 |
| data.included[*].attributes.title | 关卡名称 |
| data.included[*].attributes.sequence | 项目关卡顺序 |
| data.included[*].attributes.is_from_assistant | 是否来自带教布置的任务，0：否，项目自身的关卡；1：是 |
| data.included[*].attributes.status | 关卡状态；0：未开始 3：通关中 4：已通关 5：通关失败 |
| data.included[*].attributes.duration | 课程关卡完成所需时间 |
# 获取已发布培训计划列表
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/roadmap_plans
# 参数说明：
支持分页参数和排序：（通用说明？）
支持时间范围过滤
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| sort | 否 | created_at | 排序参数，支持按培训计划的created_at, ended_at排序 |
| team_id | 否 | 无 | K吧id |
| filter[started_at][since] | 否 | 无 | 培训计划的开始时间：开始日期(包含)。格式：2023-03-08 当时间格式为：2023-03-08 12:00:01 时间筛选从此刻开始（包含前s） |
| filter[started_at][until] | 否 | 无 | 培训计划的开始时间：结束日期(不包含)。格式：2023-03-09 当时间格式为：2023-03-09 12:00:05 时间筛选从此刻结束（不包含前s） |
| filter[ended_at][since] | 否 | 无 | 培训计划的截止时间：开始日期(包含)。格式：2023-03-08 当时间格式为：2023-03-08 12:00:01 时间筛选从此刻开始（包含前s） |
| filter[ended_at][until] | 否 | 无 | 培训计划的截止时间：结束日期(不包含)。格式：2023-03-09 当时间格式为：2023-03-09 12:00:05 时间筛选从此刻结束（不包含前s） |
| filter[updated_at][since] | 否 | 无 | 培训计划的更新时间：开始日期(包含)。格式：2023-03-08 当时间格式为：2023-03-08 12:00:01 时间筛选从此刻开始（包含前s） |
| filter[updated_at][until] | 否 | 无 | 培训计划的更新时间：结束日期(不包含)。格式：2023-03-09 当时间格式为：2023-03-09 12:00:05 时间筛选从此刻结束（不包含前s） |
# 响应document
# 200 OK 状态码
{
"data": [
{
"type": "plan",
"id": "59aa211088a011f0b41c527bd216452f",
"attributes": {
"title": "年--审批--02",
"plan_type": "annual",
"plan_year": "2020",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 140000131,
"started_at": "2025-09-03 16:28:00",
"ended_at": "2025-09-11 16:28:00",
"total_budget": "11.00",
"training_form": "external",
"training_level": "department",
"predicted_credits": 1100,
"roadmap_count": 0,
"attend_count": 11,
"attendees": "第四十是对的是的是",
"description": "四大四大四大四大四大四大三",
"created_at": "2025-09-03 16:31:12",
"updated_at": "2025-09-03 16:31:12"
}
},
{
"type": "plan",
"id": "4d8476bc87e511f0b5b43e2f7048a9cc",
"attributes": {
"title": "计划名称示例2",
"plan_type": "annual",
"plan_year": "2024",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 140000183,
"started_at": "2024-09-01 00:00:00",
"ended_at": "2024-10-01 00:00:00",
"total_budget": "88888.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 20000,
"roadmap_count": 0,
"attend_count": 100,
"attendees": "工程师",
"description": "",
"created_at": "2025-09-02 18:12:16",
"updated_at": "2025-09-02 18:12:16"
}
},
{
"type": "plan",
"id": "4b1050c287e511f0a6553e2f7048a9cc",
"attributes": {
"title": "计划名称示例1",
"plan_type": "annual",
"plan_year": "2024",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 140000183,
"started_at": "2024-09-01 00:00:00",
"ended_at": "2024-10-01 00:00:00",
"total_budget": "88888.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 20000,
"roadmap_count": 0,
"attend_count": 100,
"attendees": "工程师",
"description": "",
"created_at": "2025-09-02 18:12:12",
"updated_at": "2025-09-02 18:12:12"
}
},
{
"type": "plan",
"id": "7f25aeb084a311f08dfacad51de1b8db",
"attributes": {
"title": "余--成功--0K",
"plan_type": "temporary",
"plan_year": "",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 1,
"started_at": "2025-05-01 00:00:00",
"ended_at": "2025-10-01 00:00:00",
"total_budget": "88888.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 20000,
"roadmap_count": 0,
"attend_count": 100,
"attendees": "工程师",
"description": "DSDSDSSD",
"created_at": "2025-08-29 14:43:39",
"updated_at": "2025-09-03 16:39:53"
},
"relationships": {
"team": {
"data": {
"type": "team",
"id": "0dc00e9608d211ed9b464202d65f347f"
}
},
"department": {
"data": {
"type": "department",
"id": "3"
}
}
}
},
{
"type": "plan",
"id": "de73680a847e11f0933a12580e0d60df",
"attributes": {
"title": "8.29--新建--存量--01",
"plan_type": "annual",
"plan_year": "2022",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 30,
"started_at": "2025-08-29 10:14:00",
"ended_at": "2025-08-30 10:14:00",
"total_budget": "1.00",
"training_form": "external",
"training_level": "department",
"predicted_credits": 100,
"roadmap_count": 0,
"attend_count": 1,
"attendees": "的是的是的所",
"description": "大萨达",
"created_at": "2025-08-29 10:21:28",
"updated_at": "2025-08-29 10:21:28"
}
},
{
"type": "plan",
"id": "15387bf283f111f098e33226aac8c9dd",
"attributes": {
"title": "计划名称示例3",
"plan_type": "annual",
"plan_year": "2024",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 140000183,
"started_at": "2024-09-01 00:00:00",
"ended_at": "2024-10-01 00:00:00",
"total_budget": "88888.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 20000,
"roadmap_count": 0,
"attend_count": 100,
"attendees": "工程师",
"description": "",
"created_at": "2025-08-28 17:26:31",
"updated_at": "2025-08-28 17:26:31"
},
"relationships": {
"team": {
"data": {
"type": "team",
"id": "0dc00e9608d211ed9b464202d65f347f"
}
}
}
}
],
"links": {
"first": "https://lxapi.lexiangla.net/cgi-bin/v1/roadmap_plans?page=1",
"last": "https://lxapi.lexiangla.net/cgi-bin/v1/roadmap_plans?page=17",
"prev": null,
"next": "https://lxapi.lexiangla.net/cgi-bin/v1/roadmap_plans?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 17,
"path": "https://lxapi.lexiangla.net/cgi-bin/v1/roadmap_plans",
"per_page": 20,
"to": 20,
"total": 340
},
"included": [
{
"type": "team",
"id": "0dc00e9608d211ed9b464202d65f347f",
"attributes": {
"code": "k101313",
"name": "测试K吧--项目",
"type": 2,
"logo": "https://km.lexiangla.net/assets/e037138e08d111edbc1c4202d65f347f",
"signature": "K吧介绍",
"is_secret": 0,
"application": [
"knowledge",
"event",
"album",
"survey",
"exam",
"course",
"liveroom",
"share",
"roadmap",
"collection"
]
},
"links": {
"platform": "https://km.lexiangla.net/teams/k101313"
}
},{
"type": "department",
"id": 3,
"attributes": {
"name": "产品组",
"order": 400
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.attributes.title | 培训计划名称 |
| data.attributes.plan_type | 培训计划类型； annual：年度计划，quarterly：季度计划，monthly：月度计划，temporary：临时计划 |
| data.attributes.plan_year | 计划年度 |
| data.attributes.plan_quarter | 计划季度 |
| data.attributes.plan_month | 计划月度 |
| data.attributes.implementing_dept | 应完成人数 |
| data.attributes.started_at | 计划实施开始时间 |
| data.attributes.ended_at | 计划实施结束时间 |
| data.attributes.total_budget | 总预算 |
| data.attributes.training_form | 培训形式；internal：内部培训， external：外部培训 |
| data.attributes.training_level | 培训级别；company：公司级，department：部门级 |
| data.attributes.predicted_credits | 预计学分 |
| data.attributes.roadmap_count | 关联项目数 |
| data.attributes.attend_count | 培训人数 |
| data.attributes.attendees | 培训对象 |
| data.attributes.description | 培训计划说明 |
| data.attributes.created_at | 培训计划创建时间 |
| data.attributes.updated_at | 培训计划更新时间 |
| data.links | 培训计划链接 |
| data.relationships.team | 培训计划所属的K吧 |
| data.relationships.department | 培训计划实施的部门 |
# 获取单个培训计划信息
# 接口调用说明：
GET https://lxapi.lexiangla.com/cgi-bin/v1/roadmap_plans/{plan_id}
# 参数说明：
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
| plan_id | 是 | 无 | 培训计划id |
# 响应document
# 200 OK 状态码
{
"data": {
"type": "plan",
"id": "fdfe8b48870611f0b6b90242c0a8c012",
"attributes": {
"title": "测试培训计划",
"plan_type": "annual",
"plan_year": "2020",
"plan_quarter": "",
"plan_month": "",
"implementing_dept": 3,
"started_at": "2025-09-01 15:40:00",
"ended_at": "2025-09-11 15:40:00",
"total_budget": "111.00",
"training_form": "internal",
"training_level": "company",
"predicted_credits": 100,
"roadmap_count": 1,
"attend_count": 1,
"attendees": "所有人",
"description": "11212121",
"created_at": "2025-09-01 15:40:54",
"updated_at": "2025-09-01 15:41:14"
},
"relationships": {
"department": {
"data": {
"type": "department",
"id": "3"
}
},
"team": {
"data": {
"type": "team",
"id": "0dc00e9608d211ed9b464202d65f347f"
}
},
"managers": {
"data": [
{
"type": "staff",
"id": "lisi"
},
{
"type": "staff",
"id": "wangwu"
}
]
}
}
},
"included": [
{
"type": "department",
"id": 3,
"attributes": {
"name": "产品组",
"order": 400
}
},{
"type": "team",
"id": "0dc00e9608d211ed9b464202d65f347f",
"attributes": {
"code": "k101313",
"name": "测试K吧--项目",
"type": 2,
"logo": "https://km.lexiangla.net/assets/e037138e08d111edbc1c4202d65f347f",
"signature": "K吧介绍",
"is_secret": 0,
"application": [
"knowledge",
"event",
"album",
"survey",
"exam",
"course",
"liveroom",
"share",
"roadmap",
"collection"
]
}
},
{
"type": "staff",
"id": "lisi",
"attributes": {
"name": "lisi",
"english_name": null,
"organization": "1\\2 "
}
},
{
"type": "staff",
"id": "wangwu",
"attributes": {
"name": "wangwu",
"english_name": null,
"organization": "1\\140 开发"
}
}
]
}
# 参数说明：
| 参数 | 说明 |
|---|---|
| data.attributes.title | 培训计划名称 |
| data.attributes.plan_type | 培训计划类型； annual：年度计划，quarterly：季度计划，monthly：月度计划，temporary：临时计划 |
| data.attributes.plan_year | 计划年份 |
| data.attributes.plan_quarter | 计划季度 |
| data.attributes.plan_month | 计划月度 |
| data.attributes.implementing_dept | 应完成人数 |
| data.attributes.started_at | 计划实施开始时间 |
| data.attributes.ended_at | 计划实施结束时间 |
| data.attributes.total_budget | 总预算 |
| data.attributes.training_form | 培训形式；internal：内部培训， external：外部培训 |
| data.attributes.training_level | 培训级别；company：公司级，department：部门级 |
| data.attributes.predicted_credits | 预计学分 |
| data.attributes.roadmap_count | 关联项目数 |
| data.attributes.attend_count | 培训人数 |
| data.attributes.attendees | 培训对象 |
| data.attributes.description | 培训计划说明 |
| data.attributes.created_at | 培训计划创建时间 |
| data.attributes.updated_at | 培训计划更新时间 |
| data.relationships.team | 培训计划所属的K吧 |
| data.relationships.department | 培训计划实施的部门 |
| data.relationships.managers | 培训计划的负责人 |