本文介绍如何使用企业要素验证V2接口实现企业要素信息一致性验证,识别企业信息真实性。
基础信息
接口名:EntElementVerifyV2
服务地址:cloudauth.aliyuncs.com
请求方法:POST和GET
传输协议:HTTPS
接口说明:企业要素验证接口为您提供企业要素信息一致性验证服务,用于识别企业信息的真实性。
其中企业二、三要素支持企业、个体工商户、农民专业合作社、机关、事业单位、社会团体、律师职业机构、业主大会等各类机构;
企业四要素支持企业、个体工商户、农民专业合作社、律师职业等机构。
QPS限量:API独享QPS限量,详情请参见企业身份识别接口QPS限量说明。
请求参数
|
字段 |
类型 |
是否必传 |
描述 |
示例值 |
|
SceneCode |
String |
是 |
自定义场景code,用户自定义取值,用于区分业务场景。支持字母、数字、下划线的组合,最长32位。 |
1000000006 |
|
MerchantBizId |
String |
是 |
商户侧自定义的业务唯一标识,用于后续定位排查问题。支持字母和数字的组合,长度最长32位,请确保唯一。 |
e0c34a77f5ac40a5aa5e6ed20c35**** |
|
MerchantUserId |
String |
是 |
商户侧用户ID。支持字母和数字的组合,长度最长32位。 |
mch7x9a2b4c8d3e5f6g1h2i3j4k5**** |
|
UserAuthorization |
String |
是 |
是否获得用户授权:
|
1 |
|
InfoVerifyType |
String |
是 |
企业要素核验类型:
|
ENT_2META |
|
LicenseNo |
String |
是 |
统一社会信用代码。 |
91330106673959**** |
|
EntName |
String |
是 |
企业名称。 |
****有限公司 |
|
LegalPersonName |
String |
否 |
法人姓名。 说明
三要素、四要素场景必传。 |
张** |
|
LegalPersonCertNo |
String |
否 |
法人身份证号。 说明
四要素场景必传。 |
1******************9 |
响应参数
|
字段 |
类型 |
描述 |
||
|
HTTP Status Code |
Integer |
HTTP状态码。 |
||
|
HTTP Body |
RequestId |
String |
请求ID。 |
|
|
Code |
String |
返回码,详见返回码。 |
||
|
Message |
String |
响应详细信息。 |
||
|
Result |
BizCode |
String |
核验结果码:
|
|
|
ReasonDetail |
String |
不一致详情,出现多项不一致会以英文逗号隔开。
说明
示例: |
||
|
Status |
String |
经营状态:
|
||
|
OpenTime |
String |
营业期限:营业开始时间和结束时间。
|
||
返回码
|
HTTP Status Code |
Code |
描述 |
|
200 |
Success |
成功。 |
|
400 |
MissingParameter |
缺少必须参数。 |
|
400 |
InvalidParameter |
参数不合法。 |
|
403 |
Forbidden.AccountAccessDenied |
无权限,可能是未开通服务,或已欠费。 |
|
403 |
Forbidden.RAMUserAccessDenied |
RAM用户无权限,请授权 AliyunYundunCloudAuthFullAccess。 |
|
403 |
Forbidden.NoUserAuthorization |
没有获得用户授权。 |
|
500 |
InternalError |
系统内部错误,建议重试或记录错误request ID后提交技术支持专家确认。 |
Demo参考
您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
说明注意选择所需的编程语言。
如果您有离线安装的需求,可以进入SDK安装页面选择需要语言的SDK,并转到发布地址获取。