6. 知识点管理接口指南

## 6.1 概述
码学堂教学平台提供知识点管理接口，商户可在自己的系统实现知识点的增加、修改与删除功能。
## 6.2 知识点管理
### 6.2.1 请求参数说明
| 序号 |   参数   | 名称 |  是否必须提供 |描述 |
|  :----:  | :----:  | :----:  | :----:  |:----  |
|  01 | merchant_id | 商户号 | 是 |  直接写“0”  |
|  02 | kp_text | 课程/知识点/章节名称 | 是| |
|  03 | sign | 签名 | 是 | SHA256签名 |
|  04 | kp_level | 级别 | 是 | 整型{1,2,3}，1表示课程，2表示章，3表示节 |
|  05 | img_url | 封面图片地址 | 否 | 建议使用480x270的图片，kp_level为1有效|
|  06 | email | 教师账号|是|机构下的教师码学堂账号|
|  07 | kp_desc | 课程描述|否|1000字以内，kp_level为1有效|
|  08 | timestamp | 时间戳 | 否 |建议提供|
|09|show_flg|显示顺序|否|默认为0,越大越靠后|
|10|parent_id|父ID|是|kp_level为2时,为课程kp_id,如果kp_level为3时,加入所属章的kp_id，kp_level为1时，传0|
|11|email|教师的登录账号|是|通常为邮箱|

所有字段均参加签名
### 6.2.2 请求地址及方式
增加知识点地址：`https://mp.api.maxuetang.cn/kp-insert`
个性知识点地址：`https://mp.api.maxuetang.cn/kp-update`
删除知识点地址：`https://mp.api.maxuetang.cn/kp-delete`
请求方式：`POST`
### 6.2.3 返回JSON参数说明
```json
{
	"success": true,
	"msg": "成功",
	"data": {
		"img_url": "https:\/\/www.maxuetang.cn\/lxojres\/index\/img\/ic_subject_2@2x.png",
		"parent_id": "0",
		"uid": "54*************7",
		"kp_desc": "这是一门计算机专业课程",
		"kp_id": "2504",
		"kp_text": "数据结构与算法1",
		"show_flg": "0",
		"kp_level": "1"
	}
}
```
| 序号 |   参数   | 名称 | 描述 |
|  :----  | :----:  | :----:  |:----  |
|01|success|成功标识|true 或 false|
|02|msg|消息|返回执行消息|
|03|data|数据|返回数据对象|
|04|uid|教师ID||

其他返回値与提交时同义

### 6.2.4 接入示例
接入时需要对上传数据进行签名，具体签名示例请移步https://help.maxuetang.cn/project-9/doc-103/
```java
package com.mxt.demo.kp;

import java.util.Map;
import java.util.TreeMap;
import com.mxt.sign.SignHelper;

import cn.hutool.http.HttpUtil;
////hutool-all-4.6.7.jar
public class DemoKp {
	//新增一门课程 
	public static void addCourse() {
		String url = "https://mp.api.maxuetang.cn/kp-insert";
		Map params = new TreeMap();
		params.put("merchant_id",  "0");
		params.put("kp_text",  "数据结构与算法1");//课程名称,必须
		params.put("kp_level",  );//增加一门课程的标识,必须
		params.put("img_url",  "https://www.maxuetang.cn/lxojres/index/img/ic_subject_2@2x.png");//封面图片地址,建议使用480x270的图片，可选
		params.put("email",  "xxxx@qq.com");//码学堂教师账号
		params.put("kp_desc",  "这是一门计算机专业课程");//课程描述，1000字以内，可选
		params.put("timestamp",  System.currentTimeMillis());
		params.put("sign",  SignHelper.sign(params, "商户密钥"));//签名
		String result = HttpUtil.post(url, params);
		System.out.println("执行结果："+result);
	}
	//新增一个章节
	public static void addKp() {
		String url = "https://mp.api.maxuetang.cn/kp-insert";
		Map params = new TreeMap();
		params.put("merchant_id",  "0");
		params.put("kp_text",  "第二章 线性表");//课程/知识点/章节名称,必须
		params.put("kp_level",  3);//增加章节的标识,2为章,3为节,必须
		params.put("parent_id",  2500);//如果为kp_level为2时,这里加入课程kp_id,如果为3时,加入所属章的kp_id,必须
		params.put("show_flg",  1);//章节显示顺序,默认为0,越大越靠后,可选
		params.put("email",  "xxxx@qq.com");//码学堂教师账号
		params.put("timestamp",  System.currentTimeMillis());
		params.put("sign",  SignHelper.sign(params, "商户密钥"));
		String result = HttpUtil.post(url, params);
		System.out.println("执行结果："+result);
	}
	
	//更新课程或章节信息
	public static void updateKp() {
		String url = "https://mp.api.maxuetang.cn/kp-update";
		Map params = new TreeMap();
		params.put("merchant_id",  "0");
		params.put("kp_id",  2500);//课程或章节ID,必须
		params.put("kp_text", "第二章 线性表修改2");//课程或章节名称,可选
		params.put("show_flg", 10);//章节显示顺序,默认为0,越大越靠后,可选
		params.put("img_url",  "https://www.maxuetang.cn/lxojres/index/img/ic_subject_2@2x.png");//封面图片地址(为课程时有效),建议使用480x270的图片，可选
		params.put("kp_desc",  "这是一门计算机专业课程2");//课程描述，1000字以内，可选
		params.put("email",  "xxxx@qq.com");//码学堂教师账号
		params.put("timestamp",  System.currentTimeMillis());
		params.put("sign",  SignHelper.sign(params, "商户密钥"));
		String result = HttpUtil.post(url, params);
		System.out.println("执行结果："+result);
	}
	
	//删除课程或章节信息
	public static void deleteKp() {
		String url = "https://mp.api.maxuetang.cn/kp-delete";
		Map params = new TreeMap();
		params.put("merchant_id", "商户ID");
		params.put("kp_id",  2401);//课程或章节ID,必须
		params.put("email",  "xxx@qq.com");//码学堂教师账号
		params.put("timestamp",  System.currentTimeMillis());
		params.put("sign", SignHelper.sign(params, "商户密钥"));
		String result = HttpUtil.post(url, params);
		System.out.println("执行结果："+result);
	}
}

```