调用 QueryBidUserCertifiedInfo 查询虚商客户实名认证信息。
接口说明
调用 QueryBidUserCertifiedInfo 时,公共请求参数中的 AccessKeyId 必须为虚商主账号的密钥 ID。
请求参数
名称 |
类型 |
是否必填 |
示例值 |
描述 |
Action |
String |
是 |
QueryBidUserCertifiedInfo |
系统规定参数,取值:QueryBidUserCertifiedInfo |
PK |
String |
是 |
123******567 |
被实名认证的阿里云账号数字 ID |
bidType |
String |
是 |
LIGHTWEIGHT |
虚商类型,取值:
- NORMAL:BID服务虚商
- LIGHTWEIGHT:轻量级虚商
|
返回值
名称 |
类型 |
示例值 |
描述 |
aliyunPk |
String |
175*******787 |
被认证的虚商客户阿里云账号PK,即虚商客户 UID |
isCertified |
String |
1 |
是否已认证:
|
phone |
String |
158******** |
手机号 |
accountCertType |
String |
enterprise |
认证类型:
- personal 表示个人
- enterprise 表示企业
|
name |
String |
张三 |
认证主体名称 |
certType |
String |
0 |
证件类型编码,例如:0 |
certNumber |
string |
340321******** |
证件号 |
表 1. 证件类型说明
名称 |
说明 |
编码(返回值) |
ID |
身份证 |
"0" |
BUSINESS |
营业执照 |
"9" |
ORGANIZATION_CODE |
组织机构代码证书 |
"12" |
INSTITUTION_LEGAL_PERSON |
事业法人证书 |
"13" |
请求示例
https://crm-cn-hangzhou.aliyuncs.com/?Action=QueryBidUserCertifiedInfo
&PK=123******567
&<公共请求参数>
返回示例
示例 1(未实名认证)
{
"requestId": "90B72FBF-D299-4D17-B84C-9954B45AFE65",
"result": "{\"aliyunPk\":\"175*******787\",\"isCertified\":\"0\"}"
}
示例 2(已实名认证)
{
"requestId": "53AA9A73-BD88-43C1-8AB5-390A875F6976",
"result": "{\"aliyunPk\":\"175*******787\",\"isCertified\":\"1\",\"certNumber\":\"fffffff\",\"phone\":\"9999\",\"certType\":\"0\",\"name\":\"xxxxxxxx\",\"accountCertType\":\"enterprise\"}"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 |
Empty PK |
The input parameter 'PK' mandatory for processing this request is not supplied. |
PK 必填 |
403 |
Not Bid |
The interface can not be called by a non-bid account. |
调用方不是一个虚商用户 |
403 |
Bid Mismatch |
Pk is not belong to the Bid. |
被调用方不属于此虚商用户(即被调用的阿里云 PK 并非由此虚商创建) |
404 |
Invalid PK |
The specified parameter 'PK' does not exist in our records. |
此 PK 对应账号不存在 |