本文介绍如何使用企业要素验证接口实现企业要素信息一致性验证,识别企业信息真实性。
基础信息
接口名:EntElementVerify
服务地址: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 | 核验结果码:
| |
ReasonCode | String | ReasonCode说明:
说明 此字段于2023年6月15日停止使用,已接入老客户不受影响。 | ||
ReasonDetail | String | 不一致详情,出现多项不一致会以英文逗号隔开。
说明 示例: | ||
Status | String | 经营状态:
| ||
OpenTime | String | 营业期限:包括营业开始时间和结束时间。
|
返回码
HTTP Status Code | Code | 描述 |
200 | Success | 成功。 |
400 | MissingParameter | 缺少必须参数。 |
401 | InvalidParameter | 参数不合法。 |
403 | Forbidden.AccountAccessDenied | 无权限,可能是未开通服务,或已欠费。 |
403 | Forbidden.RAMUserAccessDenied | RAM用户无权限,请授权 AliyunYundunCloudAuthFullAccess。 |
403 | Forbidden.NoUserAuthorization | 没有获得用户授权。 |
500 | InternalError | 系统内部错误,建议重试或记录错误request ID后提交技术支持专家确认。 |
SDK和代码示例
您可以在OpenAPI的在线接口调试页面的右侧找到对应的SDK调用示例,并在代码示例的右上角点击SDK安装信息查看SDK的安装信息。
说明注意选择所需的编程语言。
如果您有离线安装的需求,可以进入SDK安装页面选择需要语言的SDK,并转到发布地址获取。