本文介绍如何使用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后提交技术支持专家确认。 |