# 校验客户注册信息-CheckUserIdentity
#### 功能介绍
客户注册时可检查客户的登录名称、手机号或者邮箱是否可以用于注册。
#### 接口约束
该接口只允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=BSS&api=CheckUserIdentity)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
操作员账号调用当前API需经过授权，您可以通过伙伴中心为操作员赋予相应权限项来完成授权。有关如何为角色授权的详细信息，请参见[为组织人员分配权限](https://support.huaweicloud.com/usermanual-bpconsole/zh-cn_topic_0072435164.html)。
接口对应的权限项如下：
| **场景** | **子场景** | 接口名称     | 接口URL                                                | 权限项                         | 权限项名称                         |
|:---|:---|:---|:---|:---|:---|
| 管理客户   | 注册客户    | 检验客户注册信息 | POST /v2/partners/sub-customers/users/check-identity | BPC_ITEM_SUBCUSTSERV_010118 | 销售-客户-客户管理-客户列表-创建伙伴子客户（能力开放） |
   
#### URI
POST /v2/partners/sub-customers/users/check-identity
#### 请求消息
**请求参数**
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| search_type  | 是    | String | **参数解释：** 校验类型。 **约束限制：** 不涉及 **取值范围：** - email：邮箱  - mobile：手机号  - name：登录名称   **默认取值：** 不涉及                                                                                                                                                                                                 |
| search_value | 是    | String | **参数解释：** 校验内容。可以为手机号、邮箱或登录名称。 **约束限制：** - 手机号需符合正则表达式 \^\\d{4}-\\d+$；包括国家码，以00开头，格式：00XX-XXXXXXXX。目前手机号仅支持以86开头的国家码。  - 邮箱需为含有@的正确格式的完整邮箱地址。  - name：符合正则表达式\^(\[a-zA-Z-\](\[a-zA-Z0-9_-\]){4,31})$，长度5-32；不能以"op_"或"shadow_"开头且不能全为数字，且只能以字母（不区分大小写）或者-开头。   **取值范围：** 最大长度：64 **默认取值：** 不涉及 |
   
**请求示例**
```
POST https://bss.myhuaweicloud.com/v2/partners/sub-customers/users/check-identity HTTP/1.1
Content-Type: application/json
X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ
{
  "search_type": "name", 
  "search_value": "ceshiyonghu001"
}
```
#### 响应消息
**响应参数**
| 参数                          | 参数类型    | 描述                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| error_code                  | String  | **参数解释：** 状态码。具体请参考[状态码]。 **取值范围：** 最大长度：16                                                                                                                                                   |
| error_msg                   | String  | **参数解释：** 错误描述信息。 **取值范围：** 最大长度：1024                                                                                                                                                                                            |
| check_result                | String  | **参数解释：** 检验结果。 **取值范围：** - available：该登录名称/手机号/邮箱有效。  - used_by_user：该登录名称/手机号/邮箱已被占用。   |
| mobile_remain_available_num | Integer | **参数解释：** 手机号剩余可注册客户数量。 只有search_type=mobile时，该字段才返回值。表示可以继续使用该手机号注册客户的数量。                                                                                                                                                                                  |
   
**响应示例**
```
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",
    "check_result": "available",
    "mobile_remain_available_num": 1
}
```
 #### 状态码
![](https://support.huaweicloud.com/api-bpconsole/public_sys-resources/note_3.0-zh-cn.png)
- 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。
- 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。
 
| HTTP状态码 | 错误码      | 描述    |
|:---|:---|:---|
| 400     | CBC.0100 | 参数错误。 |
| 403     | CBC.0151 | 访问拒绝。 |
| 500     | CBC.0999 | 其他错误。 |