本文介绍如何使用基础模型接口实现企业真实性评级。
基础信息
接口名:EntVerify。
服务地址:cloudauth.aliyuncs.com。
请求方法:POST和GET。
传输协议:HTTPS。
接口说明:基础模型接口为您提供企业真实性评级服务,您可以参考接口返回的评级结合业务场景规则处置。
请求参数
字段 | 类型 | 是否必选 | 描述 | 示例值 |
SceneCode | String | 是 | 自定义场景code,用户自定义取值,用于区分业务场景。支持字母、数字、下划线的组合,最长32位。 | 1000000006 |
MerchantBizId | String | 是 | 自定义的业务唯一标识,用于后续定位排查问题使用。支持长度为32位的字母和数字的组合,请确保唯一。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
MerchantUserId | String | 是 | 您业务中自定义用户ID,用于后续定位排查问题使用。 | 无 |
UserAuthorization | String | 是 | 是否获得得用户授权。
| 1 |
RiskVerifyType | String | 否 | 企业风险核验类型,目前支持BUSINESS_ANTIFRAUD:经营真实性评级。 | BUSINESS_ANTIFRAUD |
RiskModelVersion | String | 否 | 企业风险核验模型版本,RiskVerifyType不为空时必传,目前支持 BASIC:基础版。 | BASIC |
LicenseNo | String | 是 | 统一社会信用代码。 | 91330106673959**** |
EntName | String | 否 | 企业名称。 | ****有限公司 |
LegalPersonName | String | 否 | 法人姓名。 | 张** |
LegalPersonCertNo | String | 是 | 法人身份证号。 | 1******************9 |
LegalPersonMobile | String | 否 | 法人手机号。 | 1390000**** |
AccountNo | String | 否 | 收款账户,辅助提升风险评估效果。 | 2013092809********* |
响应参数
字段 | 类型 | 描述 | |||
HTTP Status Code | Integer | HTTP状态码。 | |||
HTTP Body | RequestId | String | 请求ID。 | ||
Code | String | 返回码,详见下方返回码。 | |||
Message | String | 响应详细信息。 | |||
Result | RiskVerifyResult | Found | Boolean | 是否查到结果,查得计费。 | |
ModelResults | List<EntRiskVerifyModelResult> | 企业真实性评级返回结果列表。EntRiskVerifyModelResult结构:
|
返回码
HTTP Status Code | Code | 描述 |
200 | Success | 成功。 |
400 | MissingParameter | 缺少必须参数。 |
401 | InvalidParameter | 参数不合法。 |
403 | Forbidden.AccountAccessDenied | 无权限,可能是未开通服务,或已欠费。 |
403 | Forbidden.RAMUserAccessDenied | RAM用户无权限,请授权 Aliyu***FullAccess。 |
403 | Forbidden.NoUserAuthorization | 没有获得用户授权。 |
500 | InternalError | 系统内部错误,建议重试或记录错误request ID后提交技术支持专家确认。 |