loading-img
考生管理接口

1、爱科举开放接口使用JWT规范(Json web token);

2、获取AppID和AppKey,商业版用户登录管理端,进入【系统管理】-【开发平台】获取AppID和AppKey;

3、以Java开发为例,安装maven依赖:

<!-- https://mvnrepository.com/artifact/io.jsonwebtoken/jjwt -->
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
<version>0.9.1</version>
</dependency>


3、接口地址 https://admin.ikeju.net/api/{AppID}


4、生成jwt数据:

String app_key = "SV0opAea621484K3fcLRGfM05W2";
Map map = new HashMap();
map.put("action", "login");
Date now = new Date(System.currentTimeMillis());
String jwt = "";
try {
   jwt ="ikeju_"+ Jwts.builder().setClaims(map).setExpiration(new Date(now.getTime() + 1000 * 10 * 60))         .signWith(SignatureAlgorithm.HS512, app_key.getBytes("UTF-8")).compact();
} catch (UnsupportedEncodingException e) {
   e.printStackTrace();
}

代码说明:

(1)必须使用ikeju作为前缀;

(2)一定要使用getBytes("UTF-8");

(3)map.put("action", "saveUser") 为固定格式,action为saveUser表示执行的是保存考生;


5、封装数据,发送请求到接口https://admin.ikeju.net/api/{AppID}

参数编号参数名称是否必填参数示例参数说明
1userNamezhangsan

用户名

2trueName张三

真实姓名

3mobile13700000000

手机号码

4idCard

身份证号

5email       

邮箱号码

6

departName

部门名称,考生所在部门,如果该部门不存在,系统会自动生成一个部门

6、返回值为JSON格式,请求返回如下:

{"result":"succss"}

{"result":"user exit"}

result为success表示写入成功,其他表示写入失败及失败原因