公民公安不良代码查询

根据姓名、身份证号查询用户是否在公安存在不良代码

一、公共参数

• 请求地址：http://api.spiderid.cn/api/router/rest，https://api.spiderid.cn/api/router/rest

• 服务接口名称(即公共参数method的值)： realid.credit.publicSecurity

• 请求方式：POST或GET

二、请求参数

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

请求示例：

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

三、响应参数

data结果信息	类型	描述
incorrect	Integer	返回码
message	String	描述
misconductCode	String	被查询人不良代码，多个以逗号分隔，incorrect 为 100 时此字段有值, 1：其他,2：前科,3：涉毒,4：吸毒,5：在逃,6：涉案（包括在逃撤销）

四、命中不良代码示例

JSON示例

{
  "code": 0,
  "requestId": "6c576...",
  "data": {
      "incorrect": 100,
      "misconductCode": "[1,2]",
      "message": "命中不良"
  },
  "message": "success"
}

五、未命中不良代码示例

JSON示例

{
  "code": 0,
  "requestId": "dsd24...",
  "data": {
       "message": "未命中不良" ,
       "incorrect": 101 
  },
  "message": "success"
}

六、返回码说明(incorrect)

返回码	描述	是否收费
100	命中不良	是
101	未命中不良	是
102	身份证姓名不一致	是

SDK 请求示例

        //提供的url
        String url = "https://api.spiderid.cn/api/router/rest";
        //您的appKey
        String appkey = "XXX";
        //您的appSecret
        String secretKey = "XXX";
        
        //身份证姓名，注意不要有空格
        String realname = "XXX";
        //身份证号码是18位的，最后一位如果是大写X转换为x，注意不要有空格
        String idcard = "XXX";

        //1.默认客户端
        ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
        //2.调用出错自动重试客户端
        //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

        PersonPublicSecurityRequest req = new PersonPublicSecurityRequest();
        req.setRealname(realname);
        req.setIdcard(idcard);
        
        // 配置此参数时,会对请求参数中的realname、idcard做加密
        //req.setEncMethod(EncryptMethod.SM4);
        try {
            PersonPublicSecurityResponse response = apiClient.execute(req);
            //后续业务处理

        } catch (ApiException e) {
            e.printStackTrace();
        }