学历核验

根据姓名、身份证号、证书编号进行学历核验，获取得到认证token，然后根据认证token拿到核验结果信息

获取认证token

一、请求说明

• 请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
• 服务接口名称(即公共参数method的值)： riskcontrol.education.getToken
• 请求方式：POST或GET

二、请求参数

• 以下参数不能都为空，请求参数以表单形式提交,Content-Type值为: application/x-www-form-urlencoded;charset=utf-8

名称	类型	是否必须	描述
realname	String	是	身份证姓名，中文；参数支持数据加密，详情参照加密方法说明
idcard	String	是	身份证号码，18位；参数支持数据加密，详情参照加密方法说明
certificateNo	String	是	证书编号,参数支持数据加密，详情参照加密方法说明

请求示例：

http或https://api.spiderid.cn/api/router/rest?
realname=XXX
&idcard=XXX
&certificateNo=XXX
&<[公共请求参数]>

三、响应参数

data结果信息	类型	描述
incorrect	Integer	返回码
message	String	描述
token	String	认证Token
expireTime	Long	认证有效时间（单位秒）

四、成功示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '提交成功' ,
      "incorrect": 100,
      "token": "XXX",
      "expireTime": ...,
  },
  "message": "success"
}

五、失败示例

JSON示例

{
  "code": 10002,
  "requestId": "ds2d24...",
  "message": "服务异常，请联系客服",
}

六、返回码说明(incorrect)

返回码	描述
100	提交成功
101	查无记录

SDK 请求示例

    //提供的url
    String url = "http://api.spiderid.cn/api/router/rest";
    //您的appKey
    String appkey = "XXX";
    //您的appSecret
    String secretKey = "XXX";

    //身份证姓名，注意不要有空格
    String realname = "XXX";
    //身份证号码是18位的，最后一位如果是大写X转换为x，注意不要有空格
    String idcard = "XXX";
    //证书编号
    String certificateNo = "XXX";
    
    //1.原客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错，自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

    EducationGetTokenRequest req = new EducationGetTokenRequest();
    req.setRealname(realname);
    req.setIdcard(idcard);
    req.setCertificateNo(certificateNo);

    //配置此参数时,会对请求参数中的realname、idcard做加密
    //req.setEncMethod(EncryptMethod.SM4);
    try {
        EducationGetTokenResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }

获取认证状态

• 请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
• 服务接口名称(即公共参数method的值)： riskcontrol.education.status
• 请求方式：POST或GET

二、请求参数

• 以下参数不能都为空，请求参数以表单形式提交,Content-Type值为: application/x-www-form-urlencoded;charset=utf-8

名称	类型	是否必须	描述
token	String	是	认证token

请求示例：

http或https://api.spiderid.cn/api/router/rest?
token=XXX
&<[公共请求参数]>

三、响应参数

data 结果信息	类型	描述
status	String	认证状态

• status 认证状态介绍

字段	状态介绍
SUCCESS	认证成功
ACTION	认证中
FAILURE	认证失败
INVALID	认证超时

四、成功示例

JSON示例

{
  "status": "SUCCESS",
}

五、失败示例

JSON示例

{
  "code": 10023,
  "requestId":"dsd24...",
  "message": "认证记录不存在"
}

SDK 请求示例

    //提供的url
    String url = "http://api.spiderid.cn/api/router/rest";
    //您的appKey
    String appkey = "XXX";
    //您的appSecret
    String secretKey = "XXX";

    //认证token
    String token = "XXX";
    
    //1.原客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错，自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

    EducationGetStatusRequest req = new EducationGetStatusRequest();
    req.setToken(token);

    try {
        EducationGetStatusResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }

获取认证结果

• 请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest
• 服务接口名称(即公共参数method的值)： riskcontrol.education.result
• 请求方式：POST或GET

二、请求参数

• 以下参数不能都为空，请求参数以表单形式提交,Content-Type值为: application/x-www-form-urlencoded;charset=utf-8

名称	类型	是否必须	描述
token	String	是	认证token

请求示例：

http或https://api.spiderid.cn/api/router/rest?
token=XXX
&<[公共请求参数]>

三、响应参数

data 结果信息	类型	描述
incorrect	Integer	返回码
message	String	描述
info	String	json格式字符串，服务识别出的信息 详情见下面附录

附录(返回数据说明)

data 结果信息	类型	描述
gender	Integet	性别: 0-未知;1-男;2-女
birthday	Date	出生日期
entranceTime	Date	入学时间
graduationTime	Date	毕业时间
graduateCollege	String	毕业学校
major	String	专业
educationCategory	String	学历类别
schoolLength	String	学制
studyType	String	学习形式
studyLevel	String	学历层次
graduationConclusion	String	毕业结论
principalName	String	校（院）长姓名
graduationPictures	String	毕业照片
minorSchool	String	辅修学校
minorMajor	String	辅修专业
minorStartAndEndDate	String	辅修起止日期
remark	String	备注

四、成功示例

JSON示例

{
   "code": 0,
   "requestId":"dsd24...",
   "message": "success",
   "data": {
       "incorrect":100,
       "message":"一致",
       "info":.....
   }
}

五、失败示例

JSON示例

{
  "code": 10023,
  "requestId":"dsd24...",
  "message": "认证记录不存在"
}

六、返回码说明(incorrect)

返回码	描述
100	一致
101	不一致

SDK 请求示例

    //提供的url
    String url = "http://api.spiderid.cn/api/router/rest";
    //您的appKey
    String appkey = "XXX";
    //您的appSecret
    String secretKey = "XXX";

    //认证token
    String token = "XXX";
    
    //1.原客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错，自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

    EducationGetResultRequest req = new EducationGetResultRequest();
    req.setToken(token);

    try {
        EducationGetResultResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }