本文介紹如何使用企業要素驗證接口實現企業要素信息一致性驗證,識別企業信息真實性。
基礎信息
接口名: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后提交技術支持專家確認。 |