5. 知识点加载接口指南

## 5.1 概述
通过码学堂提供的知识点接口，商户可以读取权限下的知识点信息。
## 5.2 请求参数说明
| 序号 |   参数   | 名称 |  是否必须提供 |描述 |
|  :----:  | :----:  | :----:  | :----:  |:----  |
|  01 | merchant_id | 商户号 | 是 | 直接写“0” |
|  02 | kp_id | 知识点ID | 否| 指定时返回该ID所对应的知识点信息|
|03|parent_id|父知识点ID|否|指定时返回该ID下所有的子知识点信息，当kp_id没有指定时，parent_id必须指定；当kp_id指定为0时，返回商户下所有授权的一级知识点|
|  04 | sign | 签名 | 是 | SHA256签名 |
|  05 | start | 分页 | 否 | 当指定parent_id时提供 |
| 06|timestamp|时间戳|否|长整型数|
|07|email|教师的登录账号|是|通常为邮箱|
## 5.3 请求地址及方式
请求地址：`https://mp.api.maxuetang.cn/kp`
请求方式：`POST`
## 5.4 返回JSON参数说明
| 序号 |   参数   | 名称 | 描述 |
|  :----  | :----:  | :----:  |:----  |
|01|success|成功标识|true 或 false|
|02|msg|消息|返回执行消息|
|03|data|数据|返回数据对象|
|04|limit|分页大小||
|05|start|分页||
|06|rows|总记录数||
|07|parent_id|父知识点ID||
|08|kp_id|知识点ID||
|09|kp_text|知识点名称||
|10|teacher_id|教师ID|仅返回授权的教师ID|
## 5.5 接入示例
POST请求：
```java
kp?kp_id=0&parent_id=0&merchant_id=0&email=33...@qq.com&sign=8dd82f52c26...dd60731012f0
```
示例返回如下：
```json
{
    "success": true,
    "msg": "",
    "data": {
        "limit": "10",
        "start": "0",
        "rows": "1",
        "list": [
            {
                "parent_id": "0",
                "teacher_id": "555555",
                "kp_id": "917",
                "kp_text": "ICPC训练题目集"
            }
        ]
    }
}
```
### 5.5.1 Java接入示例
```java
package com.mxt.problem.load;

import java.util.Map;
import java.util.TreeMap;

import com.mxt.config.MxtApiConfig;
import com.mxt.sign.SignHelper;

import cn.hutool.http.HttpUtil;
import cn.hutool.json.JSONObject;

public class KnowledgePoint {
	public static JSONObject getKnowledgePoint(long kp_id, long parent_id, int start) {
		Map params = new TreeMap();
		params.put("merchant_id" , 0);
		params.put("email"		 , MxtApiConfig.EMAIL);
		params.put("kp_id"       , kp_id);
		params.put("parent_id"   , parent_id);
		params.put("start"       , start);
		params.put("timestamp"   , System.currentTimeMillis());
		params.put("sign"        , SignHelper.sign(params, MxtApiConfig.MERCHANT_KEY));
		
		return new JSONObject(HttpUtil.post(MxtApiConfig.KNOWLEDGE_POINT_API, params));
	}
}

```