本文介紹如何使用QueryEntRisk接口查詢企業經營異常信息。
基礎信息
接口名：QueryEntRisk。
服務地址：cloudauth.aliyuncs.com。
請求方法：POST和GET。
傳輸協議：HTTPS。
接口說明：查詢企業經營異常情況。
QPS限量：API獨享QPS限量，詳情請參見企業身份識別接口QPS限量說明。
請求參數
字段 | 類型 | 是否必選 | 描述 | 示例值 |
SceneCode | String | 是 | 自定義場景code，用戶自定義取值，用于區分業務場景。支持字母、數字、下劃線的組合，最長32位。 | 1000000006 |
MerchantBizId | String | 是 | 自定義的業務唯一標識，用于后續定位排查問題使用。支持長度為32位的字母和數字的組合，請確保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
MerchantUserId | String | 是 | 您業務中自定義用戶ID，用于后續定位排查問題使用。 | 無 |
UserAuthorization | String | 是 | 是否獲得用戶授權。
| 1 |
ParamType | String | 是 | 參數類型。
| 02 |
ParamValue | String | 是 | 根據ParamType參數類型輸入企業名稱、工商注冊號、統一社會信用代碼、組織機構代碼其中一種。 | 91330106673959**** |
響應參數
字段 | 類型 | 描述 | ||
HTTP Status Code | Integer | HTTP狀態碼。 | ||
HTTP Body | RequestId | String | 請求ID。 | |
Code | String | 返回碼，詳見返回碼。 | ||
Message | String | 響應詳細信息。 | ||
Result | BizCode | Boolean | 查詢結果。
| |
Status | String | 企業經營狀態。
| ||
RiskList | Array[Object] | 異常信息列表。 重要 異常信息列表下屬字段返回值可能會出現空值，接口對接時請做好兼容處理。 | ||
CreditCode | String | 統一社會信用代碼。 | ||
EntName | String | 企業名稱。 | ||
RegNo | String | 工商注冊號。 | ||
ListedReason | String | 被列入異常名單的原因。 | ||
ListedDate | String | 被列入異常名單日期。 示例：2023-02-03。 | ||
RemovedReason | String | 被移出異常名單原因。 | ||
RemovedDate | String | 被移出異常名單日期，示例：2023-02-03。 | ||
OperationOrg | String | 移入處理機關。 | ||
RemovedOrg | 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后提交技術支持專家確認。 |