企业要素验证

本文介绍如何使用企业要素验证接口实现企业要素信息一致性验证,识别企业信息真实性。

基础信息

接口名: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:获得授权。

  • 0:未获得授权。

1

InfoVerifyType

String

企业要素核验类型。

  • ENT_2META:二要素。

  • ENT_3META:三要素。

  • ENT_4META:四要素。

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

核验结果码。

  • 1:核验一致。

  • 2:核验不一致。

  • 3:未查得。

ReasonCode

String

ReasonCode说明:

  • 100:核验一致 。

  • 201:人企核验不一致。

  • 202:企业二要素核验不一致。

  • 301:查无企业,无法校验。

  • 302:法人在库中不存在。

说明

此字段于2023年6月15日停止使用,已接入老客户不受影响。

ReasonDetail

String

不一致详情,出现多项不一致用英文逗号隔开。

  • LegalPersonNameFlag:法人名称不一致。

  • LegalPersonCertNoFlag:法人证件号码不一致。

  • EntNameFlag:企业名称不一致。

  • LicenseNoFlag:营业执照号不一致。

示例:LegalPersonNameFlag,LegalPersonCertNoFlag

Status

String

经营状态。

  • 1:在营(开业)

  • 2:迁出

  • 3:注销

  • 4:吊销

  • 5:撤销

  • 6:停业

  • 0:其他

OpenTime

String

营业期限,包括营业开始时间和结束时间,中间用正斜线(/)分开。

  • 格式:yyyy-MM-dd/yyyy-MM-dd。

  • 返回示例:2018-09-25/9999-09-09。

返回码

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后提交技术支持专家确认。

Demo参考

Java Demo

PHP Demo

Python Demo

C# Demo

GO Demo

JS Demo