企业工商四要素核验
接口说明
[!NOTE]
企业工商四要素校验服务,该接口主要通过 企业名称、营业执照号、法人姓名、法人身份证号进行校验。该接口涉及到校验费用,如果未购买套餐需要联系商务进行购买。
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/auth/entFourVerify #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
entName | String | * | 企业名称 | |
bizLic | String | * | 统一社会信用代码/营业执照号 | |
name | String | * | 法人姓名 | |
identityCard | String | * | 法人身份证号 |
代码实现
JAVA实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("entName","XXX网络科技有限公司");//企业名称
params.put("bizLic","500240XXXXXXXXXXXXXXX");//企业证件号
params.put("name","某欧");//法人姓名
params.put("identityCard","62122631XXXXXXXXXX");//法人身份证号
ResultInfo<Void> ri= requestUtils.doPost("/v2/auth/entFourVerify",params);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"entName" => "易XX",
"bizLic" => "500XXXXXXXXXXXX",
"name" => "XXXXXXXXXXXXX",
"identityCard" =>"62122631XXXXXXXXXX",
);
//发起请求
$response=$requestUtils->doPost("/v2/auth/entFourVerify",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | json | ? | 响应内容json |
data参数说明
[!NOTE]
返回结果,参考:
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
code | String | * | 状态码1000,表示接口请求成功(不作为判断是否通过标准) |
message | String | * | 验证结果描述 |
seqNo | String | * | 请求序号 |
valid | boolean | * | true验证一致,false验证不一致 (可通过该返回结果判断企业工商四要素是否验证通过) |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":{"code":"10000","message":"验证成功","seqNo":"lo1y2p0ij32ckngOO1y2ozxbx39c1y","valid":true},"success":true}
//错误响应:
{"msg":"法人身份证不能为空","resultCode":"BUSINESS_ERROR","success":false}