文档首页/ 合作伙伴中心/ API参考/
更新时间：2024-09-26 GMT+08:00
查看PDF
分享
同步客户实名认证信息（已废弃）

同步客户实名认证信息（已废弃）

功能介绍

该接口即将下线，“实名认证”相关新接口请参考申请个人实名认证、申请企业实名认证、申请实名认证变更、查询实名认证审核结果。

客户在伙伴销售平台实名认证后，将实名认证信息同步给华为云，此时该客户在华为云为已实名认证状态。

注意事项：

  • 合作伙伴同步给华为云平台的实名认证数据需要真实有效，以防该接口被禁止调用。
  • 客户的伙伴销售平台账号需要与华为云账号关联后，客户的实名认证信息才能同步给华为云。
  • 该接口只允许使用合作伙伴AK/SK或者Token调用。

URI

PUT /v1.0/{partner_id}/partner/customer-mgr/verified-info

参数说明请参见下表。

参数

是否必选

取值范围

描述

partner_id

是

最大长度：64

合作伙伴ID（华为分配）。

获取方法请参见如何获取合作伙伴ID（partner_id）。

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

xaccountType

是

String

最大长度：64

华为分给合作伙伴的平台标识。

该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。

xaccountId

是

String

最大长度：64

伙伴销售平台的用户唯一标识，该标识的具体值由伙伴分配。

domainId

是

String

最大长度：64

华为云在通知消息中携带的华为云分配给客户的domainID。

verifiedType

是

Integer

取值[0|1]

第三方实名认证类型，取值如下：

  • 0：个人认证；
  • 1：企业认证。

类型需要与账号同步的时候，SAML断言中填写一致。华为平台会做校验。

verifiedStatus

是

Integer

固定为2

取值为：

2：已实名认证。

name

是

String

最大长度：256

认证名称。

  • 如果是个人，为个人名称。
  • 如果是企业，为企业的公司名称。

认证名称不能是纯特殊字符、纯数字或纯空格。

须知：

如果此处填写企业的公司名称，需要填写真实的公司名称。

identifyType

是

Integer

[1-11]

证件类型，取值如下：

  • 1：二代身份证
  • 2：护照
  • 3：营业执照
  • 4：一代身份证
  • 5：临时身份证
  • 11：组织结构代码

该参数取值根据verifiedType的取值有所不同：

  • verifiedType为0时支持1、2、4、5。
  • verifiedType为1时支持3、11。

verifiedNumber

是

String

最大长度：32

证件号码。

  • 如果是个人证件，校验规则为：^[0-9a-zA-Z]{1,32}$
  • 如果是企业证件，校验规则为：不包含[^!@#$%^&*<\\>]+

请求示例

PUT https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/verified-info HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
  "xaccountType":"xxx",
  "xaccountId":"xxxxxxxxxxx",
  "domainId":"e97ec022f3af448596765475941deb60",
  "verifiedType":"1",
  "verifiedStatus":"2",
  "name":"华为云",
  "identifyType":"3",
  "verifiedNumber":"432100000001234"
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

16个字符

状态码。具体请参考状态码。

error_msg

String

1024字符

错误描述信息。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: length
Date: response time  

{
  "error_code": "CBC.0000",
  "error_msg": "success"
}

状态码

  • 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
  • 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。

HTTP状态码

错误码

描述

200

CBC.0000

成功。

400

CBC.0100

输入参数校验失败。

500

CBC.0999

其他错误。

403

CBC.0151

访问拒绝。

500

CBC.5002

合作伙伴的客户不存在。

200

CBC.5005

该客户正在华为云系统认证。

200

CBC.5006

客户类型（个人/企业）和我们自身系统存储的客户类型不同。

500

CBC.5035

沙箱账号不能使用此接口。