# 个人限制高消费查询

根据姓名、身份证号查询个人限制高消费

# 一、请求说明

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

# 二、请求参数

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

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

请求示例：

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

# 三、响应参数

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

# 附录(返回数据说明)

名称	类型	描述
courtName	String	法院
caseCode	String	案号
caseStatus	String	案件状态
regDate	Date	立案日期
companyInfo	String	企业信息
applicant	String	执行申请人
headerName	String	限消令对象
publishDate	Date	发布日期
relateType	String	命中类型失信被执行人、关联案件、曾用名
caseId	String	案件 ID，不为空时，可调用案件详情查询接口

# 四、成功示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '查询成功' ,
      "incorrect": 100,
      "info": ...
  },
  "message": "success"
}

# 五、失败示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '查询失败' ,
      "incorrect": 102
  },
  "message": "success"
}

# 六、返回码说明(incorrect)

返回码	描述	是否收费
100	查询成功	是
101	查无记录	是
102	查询失败	否

# 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";
    
    //1.原客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错，自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url, appkey, secretKey);

    PersonalLimitConsumeRequest req = new PersonalLimitConsumeRequest();
    req.setRealname(realname);
    req.setIdcard(idcard);

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

← 企业限制高消费查询学历核验 →