更新时间:2023-04-19 GMT+08:00
同步客户实名认证信息(已废弃)

同步客户实名认证信息(已废弃)

功能介绍

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

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

注意事项:

  • 合作伙伴同步给华为云平台的实名认证数据需要真实有效,以防该接口被禁止调用。
  • 客户的伙伴销售平台账号需要与华为云账号关联后,客户的实名认证信息才能同步给华为云。
  • 该接口只允许使用合作伙伴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-TokenMIIPAgYJKoZIhvcNAQcCo...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

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