码学堂商户接入指南

3. 提交判题接口指南

3.1 概述

码学堂支持除主观题型外的7种题型自动判题服务，各类题目提交答案的规则不同。

3.2 请求地址及方式

请求地址：https://mp.api.maxuetang.cn/solve
请求方式：POST

3.3 提交请求参数说明

序号 参数 名称 是否必须提供 描述
01 merchant_id 商户号 是
02 ptype 题目类型 是 {1,2,3,…,8},1:判断题、2:单项选择题、3:多项选择题、4:填空题、5:程序函数题、6:程序填空题、7:编程题、8:主观题
03 sign 签名 是 SHA256签名
04 pid 题目ID 是 整型，指定时仅返回当前题目
05 ans 学生答案 是 JSON字符串，不同题型格式不同，长度不能超过8000个字符
06 timestamp 时间戳 否 长整型数
07 order_id 商户提交编号 是 商户端系统唯一编号

3.4 返回结果参数说明

序号 参数 名称 描述
01 success 成功标识 true 或 false
02 msg 消息 返回执行消息
03 data 数据 返回数据对象
04 merchant_order_id 商户提交编号 原样返回商户提交编号
05 attach_ids 程序填空题提交ID 每个空对应一个提交ID，以“,“分隔
06 ptype 题目类型
07 result 判题结果 0:未判,1:待重判,2:正在编译(程序题),3:正在判题中,4:答案正确,5:输出格式错误,6:答案错误,7:运行超时,8:内存超限,9:输出超限,10:运行错误,11:编译错误(编程题),12:编译成功,20:部分正确
08 score 得分 判题得分
09 solve_id 判题ID 码学堂判题ID
10 time 判题时间戳
11 sign 签名 码学堂返回签名
12 ans 答案
13 error 编译错误信息 程序题编译错误时返回

3.4 JAVA接入示例

  1. package com.mxt.problem.load;
  3. import java.util.Map;
  4. import java.util.TreeMap;
  6. import com.mxt.config.MxtApiConfig;
  7. import com.mxt.sign.SignHelper;
  9. import cn.hutool.http.HttpUtil;
  10. import cn.hutool.json.JSONObject;
  12. public class ProblemSolve {
  13.     public static JSONObject solveProblem(int pid, int ptype, String ans) {
  14.         Map params = new TreeMap();
  15.         params.put("merchant_id", MxtApiConfig.MERCHANT_ID);
  16.         params.put("ptype"      , ptype);
  17.         params.put("pid"        , pid);
  18.         params.put("order_id"   , System.currentTimeMillis());
  19.         params.put("timestamp"  , System.currentTimeMillis());
  20.         params.put("ans"        , ans);
  21.         params.put("sign"       , SignHelper.sign(params, MxtApiConfig.MERCHANT_KEY));
  23.         return new JSONObject(HttpUtil.post(MxtApiConfig.PROBLEM_SOLVE_API, params));
  24.     }
  25. }

3.5 判断题判题接入指南

3.5.1 请求参数ans格式

{"1":0,"0":1}
说明：key为1表示“对”，key为0表示“错”，value为1表示“已选择”，value为0表示“未选择”。

3.5.2 JAVA示例

(1) 请求代码

  1. int pid=9203;
  2. int ptype=1;
  3. String ans = "{\"1\":0,\"0\":1}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "6",
  6.         "score": "0",
  7.         "merchant_order_id": "1649214667335",
  8.         "success": "OK",
  9.         "ans": {"0":1,"1":0},
  10.         "sign": "f95cdd7a1defa3dfa299...216d3dbdd1e4",
  11.         "pid": "9203",
  12.         "ptype": "1",
  13.         "merchant_id": "82040611338",
  14.         "time": "20220406111107",
  15.         "attach_ids": "",
  16.         "solve_id": "53445073012073002"
  17.     }
  18. }

3.6 选择题判题接入指南

选择题分为单项选择题与多项选择题，提交判题答案格式相同。

3.6.1 请求参数ans格式

{"A":0,"B":0,"C":0,"D":1}
说明：key为选项，value为1表示“已选择”，value为0表示“未选择”。

3.6.2 JAVA示例

(1) 请求代码

  1. int pid=8528;
  2. int ptype=2;
  3. String ans = "{\"A\":0,\"B\":0,\"C\":0,\"D\":1}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "6",
  6.         "score": "0",
  7.         "merchant_order_id": "1649234492083",
  8.         "success": "OK",
  9.         "ans": {"A":0,"B":0,"C":0,"D":1},
  10.         "sign": "d7800c1af5dbf...da81b907f",
  11.         "pid": "8528",
  12.         "ptype": "2",
  13.         "merchant_id": "804061648",
  14.         "time": "20220406164132",
  15.         "attach_ids": "",
  16.         "solve_id": "80900261341122902"
  17.     }
  18. }

3.7 填空题判题接入指南

3.7.1 请求参数ans格式

{"1":"模型","2":"视图","3":"控制器"}
说明：key为第几个空，value为答案。

3.7.2 JAVA示例

(1) 请求代码

  1. int pid = 8369;
  2. int ptype = 4;
  3. String ans = "{\"1\":\"模型\",\"2\":\"视图\",\"3\":\"控制器\"}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "4",
  6.         "score": "3",
  7.         "merchant_order_id": "1649239248823",
  8.         "success": "OK",
  9.         "ans": {"1":{"result":1,"score":1,"ans":"模型"},"2":{"result":1,"score":1,"ans":"视图"},"3":{"result":1,"score":1,"ans":"控制器"}},
  10.         "sign": "a1d1d0ad768677ce8...f5ae3497bad23584",
  11.         "pid": "8369",
  12.         "ptype": "4",
  13.         "merchant_id": "88",
  14.         "time": "20220406180049",
  15.         "attach_ids": "",
  16.         "solve_id": "16019591061505260"
  17.     }
  18. }

3.8 程序填空题判题接入指南

3.8.1 请求参数ans格式

{"language":"c","length":3,"1":"a,+low,+mid-1,+k","2":"a,+mid+1,+high,+k+","3":"-1"}
说明：key为第几个空，value为答案，language为提交语言，length为“空”的个数。

3.8.2 JAVA示例

(1) 请求代码

  1. int pid = 7789;
  2. int ptype = 5;
  3. String ans = "{\"language\":\"c\",\"length\":3,\"1\":\"a,+low,+mid-1,+k\",\"2\":\"a,+mid+1,+high,+k+\",\"3\":\"-1\"}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "0",
  6.         "score": "0",
  7.         "merchant_order_id": "1649253219385",
  8.         "success": "OK",
  9.         "ans": {"1":{"score":0,"ans":"a, low, mid-1, k"},"2":{"score":0,"ans":"a, mid+1, high, k "},"3":{"score":0,"ans":"-1"},"length":3,"language":"c"},
  10.         "sign": "25d6ced5a696b115...ed9981cc0c157b35cec5f",
  11.         "pid": "7789",
  12.         "ptype": "5",
  13.         "merchant_id": "89998",
  14.         "time": "20220406215339",
  15.         "attach_ids": "655273,655274,655275",
  16.         "solve_id": "10549111912095337"
  17.     }
  18. }

(3) 程序填空题提交后，需要等待程序测评服务器测评后返回结果，属于异步执行，因此，需要执行查询接口方可查看测评结果，程序测评结果查询请参考《测评结果查询接口指南》。

3.9 函数题判题接入指南

3.9.1 请求参数ans格式

{"language":"c","source":"int fun(int a,int b){\n return a+b;\n}"}
说明：language为提交语言，source为程序代码。
提交语言的映射如下：

  1. {
  2.     "c": "C",
  3.     "cc": "C++",
  4.     "pas": "Pascal",
  5.     "java": "java",
  6.     "rb": "Ruby",
  7.     "sh": "Bash",
  8.     "py": "Python3",
  9.     "php": "Php",
  10.     "pl": "Perl",
  11.     "cs": "C#",
  12.     "m": "Obj-C",
  13.     "bas": "FreeBasic",
  14.     "scm": "Scheme",
  15.     "lua": "Lua",
  16.     "js": "JavaScript",
  17.     "go": "Go",
  18.     "sql": "SQL(sqlite3)",
  19.     "f95": "Fortran",
  20.     "mt": "Matlab(Octave)"
  21. }

3.9.2 JAVA示例

(1) 请求代码

  1. int pid = 1412;
  2. int ptype = 6;
  3. String ans = "{\"language\":\"c\",\"source\":\"int fun(int a,int b){\\n    return a+b;\\n}\"}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "0",
  6.         "score": "0",
  7.         "merchant_order_id": "1649323310615",
  8.         "success": "OK",
  9.         "ans": {
  10.             "language": "c",
  11.             "source": "int fun(int a,int b){\n    return a+b;\n}"
  12.         },
  13.         "sign": "5358c2decba86b0...b30aa896e2f89a27cbd896",
  14.         "pid": "1412",
  15.         "ptype": "6",
  16.         "merchant_id": "88",
  17.         "time": "20220407172150",
  18.         "solve_id": "655431"
  19.     }
  20. }

(3) 函数题提交后，需要等待程序测评服务器测评后返回结果，属于异步执行，因此，需要执行查询接口方可查看测评结果，程序测评结果查询请参考《测评结果查询接口指南》。

3.10 编程题判题接入指南

3.10.1 请求参数ans格式

{"language":"c","source":"int fun(int a,int b){\n return a+b;\n}"}
说明：language为提交语言，source为程序代码。
提交语言的映射详见3.9.1

3.10.2 JAVA示例

(1) 请求代码

  1. int pid = 1008;
  2. int ptype = 7;
  3. String ans = "{\"language\":\"c\",\"source\":\"int fun(int a,int b){\\n    return a+b;\\n}\"}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "0",
  6.         "score": "0",
  7.         "merchant_order_id": "1649326731854",
  8.         "success": "OK",
  9.         "ans": {
  10.             "language": "cc",
  11.             "source": "#include<iostream>\nusing namespace std;\nconst int N=1e5;\nint n,r,num=-1;\nint a[N];\nchar alp[10]={'A','B','C','D','E','F','G','H','I'};\nvoid print(int x){\n    if(x<10) cout<<x;\n    else cout<<alp[x-10];\n}\nint main(){\n    cin>>n>>r;\n    cout<<n<<\"=\";\n    while(n!=0){\n        a[++num]=n%r;\n        n/=r;\n        if(a[num]<0) a[num]-=r,n++;\n        //cout<<a[num]<<\"\\n\";\n    }\n    for(int j=num;j>=0;j--) if(a[j]!=0||j!=num) print(a[j]);\n    \n    cout<<\"(base\"<<r<<\")\";\n}"
  12.         },
  13.         "pid": "1008",
  14.         "ptype": "7",
  15.         "merchant_id": "88",
  16.         "time": "20220407181851",
  17.         "solve_id": "655435"
  18.     }
  19. }

(3) 编程题提交后，需要等待程序测评服务器测评后返回结果，属于异步执行，因此，需要执行查询接口方可查看测评结果，程序测评结果查询请参考《测评结果查询接口指南》。

3.11 主观题判题接入指南

3.10.1 请求参数ans格式

{"ans":"答案"}

3.10.2 JAVA示例

(1) 请求代码

  1. int pid = 8543;
  2. int ptype = 8;
  3. String ans = "{\"ans\":\"答案\"}";
  4. String result = ProblemSolve.solveProblem(pid, ptype, ans).toString();

(2) 返回json

  1. {
  2.     "success": true,
  3.     "msg": "",
  4.     "data": {
  5.         "result": "0",
  6.         "score": "0",
  7.         "merchant_order_id": "1649326583062",
  8.         "success": "OK",
  9.         "ans": {
  10.             "ans": "答案"
  11.         },
  12.         "sign": "104a1e58f673...188b8ad5a424b2b5a97a59bba2",
  13.         "pid": "8543",
  14.         "ptype": "8",
  15.         "merchant_id": "88",
  16.         "time": "20220407181623",
  17.         "solve_id": "32433312104014822"
  18.     }
  19. }

(3) 主观题提交后，仅作存储，不支持主观题自动判题。

码学堂管理员 2022年4月9日 18:03 收藏文档