本文介绍如何使用企业要素验证接口实现企业要素信息一致性验证,识别企业信息真实性。
基础信息
接口名:EntElementVerify。
服务地址:cloudauth.aliyuncs.com。
请求方法:POST和GET。
传输协议:HTTPS。
接口说明:企业要素验证接口为您提供企业要素信息一致性验证服务,用于识别企业信息的真实性。
QPS限量:API独享QPS限量,详情请参见企业身份识别接口QPS限量说明。
请求参数
字段 | 类型 | 是否必传 | 描述 | 示例值 |
SceneCode | String | 是 | 自定义场景code,用户自定义取值,用于区分业务场景。支持字母、数字、下划线的组合,最长32位。 | 1000000006 |
MerchantBizId | String | 是 | 商户侧自定义的业务唯一标识,用于后续定位排查问题使用。支持字母和数字的组合,长度最长32位,请确保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
MerchantUserId | String | 是 | 商户侧用户ID。支持字母和数字的组合,长度最长32位。 | 无。 |
UserAuthorization | String | 是 | 是否获得用户授权。
| 1 |
InfoVerifyType | String | 是 | 企业要素核验类型。
| 无 |
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后提交技术支持专家确认。 |