1. 概述与接入流程

# 1.1 接口服务API简介
码学堂向其他想做测评系统但不想投入太多成本的商户（机构）开放题目与测评服务，让商户把重要精力集中于主要业务方面。接口服务API向开发者提供HTTP接口，开发者（商户）可通过提供的接口引用码学堂的8种类型题目，并提供除主观题型外的自动判题功能，以JSON格式返回结果。
码学堂接口服务API对所有经过码学堂授权的用户开放。使用接口服务之前，开发者需要申请授权开通商户权限，从而获得商户密钥（key），不同级别的商户有不同的数据访问权限。
# 1.2 商户类型
个人版：可引用经过码学堂教师用户同意引用的题目，具有对应题目的自动判题服务权限。
企业版：可引用经过码学堂教师用户同意引用的题目、公开的题目，具有对应题目的自动判题服务权限。
# 1.3 账号与用户密钥（Key）的授权
（1）联系码学堂管理员，QQ号：342956433，也可发QQ邮件，注明开通码学堂商户，并提供您的联系方式；
（2）开通后，使用商户号与登录密码登录码学堂商户管理系统获取密钥。
# 1.4 接入流程
第一步：申请开通商户授权，登录商户管理后台(http://mp.api.maxuetang.cn/index.html )， 获取商户密钥；
第二步：在商户后台中，邀请码学堂教师加入商户机构，教师同意授权后即可。[参考](http://help.maxuetang.cn/project-9/doc-75/ "参考")
第三步：通过接口管理课程/知识点（也可登录码学堂完成）；
第四步：通过接口增加/修改题目（也可登录码学堂完成）；
第五步：自动测评服务接入。
# 1.5 题目类型
码学堂提供8种类型题目，题目类型编号与题目类型描述如下：

|  题目类型编号   | 题目类型  |
|  :----:  | :----:  |
|1|判断题|
|2|单选题|
|3|多选题|
|4|填空题|
|5|程序填空题|
|6|函数题|
|7|编程题|
|8|主观题|

# 1.6 接入错误代码
|  错误代码   | 描述  |
|  :----:  | :----:  |
|  601 | 没有提供商户号 |
|  602 | 没有提供签名 |
|  603 | 无效的商户 |
|  605 | 签名失败 |
|  606 | 商户已经过期 |
|  607 | 题目类型错误 |
|  608 | 未找到此题目 |
|  609 | 没有此题目的访问权限 |
|  610 | 没有查询此老师题目的权限 |
|  611 | 没有提供题目ID |
|  612 | 没有提供商户提交ID |
|  613 | 没有提供答案 |
|  614 | 答案格式错误 |
|  615 | 没有提供方案ID |
|  616 | 没有此方案 |
|  617 | 没有此方案的查询权限 |
|  618 | 今日提交次数已达上限 |
|  619 | 至少提供知识点ID或知识点父亲ID |
|620 | 程序填空题的答案数与方案数不一致|
|621|答案太长了|
|700|教师email不能为空|
|701|教师email不在商户的教师列表中|
|702|课程或章节名称没能为空|
|703|课程或章节名级别验证失败，1表示创建一门新的课程，2表示章，3表示节|
|704|当创建章时，所属课程ID不能为空|
|705|当创建节时，所属章ID不能为空|
|706|提供的email(教师账号)与kp_id(知识点ID)不匹配|
|707|课程或章节插入失败|
|708|课程或章节更新失败|
|709|具有子项，不能删除|
|710|课程描述太长了，最多1000字|
|711|题目所属知识点至少1个，最多10个|
|712|题目所属知识点中存在不是节的ID或没访问知识权限|
|800|题目选项为空或选项不规范|
|801|没有设定分数|	
|802|没有操作权限，请检查题目ID是否有误|
|803|主观题目必须提供得分点|	
|804|得分点格式错误，示例：{"0":"10","1":"10"}|
|805|样例格式错误|
|806|测试数据格式错误|
|807|测试数据只对编程题、程序填空题、函数题有效|
|808|没有测试数据|