# 企业四要素核验

核验企业名称、社会统一信用代码、法人,法人证件号一致性。

# 一、请求说明

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

# 二、请求参数

  • 请求参数以表单形式提交,Content-Type值为: application/x-www-form-urlencoded;charset=utf-8
名称 类型 是否必须 描述
entName String 企业名称
corporate String 企业法人
idcard String 企业法人证件号;参数支持数据加密,详情参照加解密方法说明
idNumber String 注册号/统一社会信用代码(注册号支持15位,统一社会信用代码支持18位)

请求示例:

http或https://api.spiderid.cn/api/router/rest?

entName=XXX

&corporate=XXX

&idcard=XXX

&idNumber=XXX

&<[公共请求参数]>

# 三、响应参数

data结果信息 类型 描述
incorrect Integer 返回码
message String 描述

# 四、成功示例

JSON示例

{
  "code": 0,
  "requestId": "ds2d24...",
  "data": {
      "message": '一致' ,
      "incorrect": 100
  },
  "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";

    //1.默认客户端
    ApiClient apiClient = new DefaultApiClient(url, appkey, secretKey);
    //2.调用出错自动重试客户端
    //AutoRetryApiClient apiClient = new AutoRetryApiClient(url,key, secretKey);
    EntFourCheckRequest req = new EntFourCheckRequest();
    req.setEntName("XXXX");
    req.setCorporate("XXXX");
    req.setIdcard("XXXX");
    //注册号/统一社会信用代码(注册号支持15位,统一社会信用代码支持18位
    req.setIdNumber("XXXX");

    // 配置此参数时,会对请求参数中的中idcard做加密
//   req.setEncMethod(EncryptMethod.SM4);
    try {
        EntFourCheckResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }
}
最后更新于: 2/9/2023, 8:12:55 PM