企业三要素核验

TIP

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

一、请求说明

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

二、请求参数

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

名称	类型	是否必须	描述
entName	String	是	企业名称
corporate	String	是	企业法人
idNumber	String	是	注册号/统一社会信用代码(注册号支持15位，统一社会信用代码支持18位)

请求示例：

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

entName=XXX

&corporate=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	查无记录	否
103	核验失败	否

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, appkey, secretKey);
    EntThreeCheckRequest req = new EntThreeCheckRequest();
    req.setEntName("XXXX");
    req.setCorporate("XXXX");
    //注册号/统一社会信用代码(注册号支持15位，统一社会信用代码支持18位
    req.setIdNumber("XXXX");
    try {
        EntThreeCheckResponse res = apiClient.execute(req);
        //后续业务处理
    } catch (ApiException e) {
        e.printStackTrace();
    }