# 新增A号码报备 - CreatePvCallerNumber
#### 接口功能
企业用户通过该接口新增租户A号码报备。
#### 使用说明
仅使用隐私号业务的用户可调用此接口，只要调用此接口新增A号码后，此租户下所有有效应用的A号码都会生效。A号码需要一次性配全，未配置的A号码可能无法呼叫。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限管理](https://support.huaweicloud.com/productdesc-PrivateNumber/privatenumber_permissions.html)。
#### URI
POST /v1.0/privatenumber/a-number
#### 请求参数
表1请求Headers参数说明 
| 参数名称         | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| Content-Type | 否    | String | **参数解释：** 消息体的类型（格式）。 **约束限制：** 不涉及。 **取值范围：** 固定填写为application/json;charset=UTF-8。 **默认取值：** 不涉及。                    |
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 说明： - Token的有效期为24小时，到期后请重新获取。  - 使用AKSK鉴权不需要携带此参数。   |
   
表2请求URL参数说明 
| 参数名称                          | 是否必选 | 参数类型    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| agree_authorization_statement | 是    | Boolean | 是否同意个人数据授权声明。 - true：同意。   说明： - "A号码报备文件上传"操作会收集您的现场照片信息，该信息属于敏感个人信息，仅用于隐私号业务向运营商报备号码，如果非本人操作，请确定已获得相应授权。  - 如果不同意个人数据授权声明，上传文件会失败。  - 点击查看[隐私政策声明](https://www.huaweicloud.com/declaration/sa_prp.html)、[服务使用声明](https://www.huaweicloud.com/declaration/tsa_privatenumber.html)。   |
   
表3请求Body参数说明 
| 参数名称    | 是否必选 | 参数类型       | 说明                |
|:---|:---|:---|:---|
| numbers | 是    | Number\[\] | A号码，一次最多可新增10个号码。 |
   
表4Number定义 
| 参数名称           | 是否必选 | 参数类型       | 说明                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| number         | 是    | String(20) | A号码。 号码格式：填写为全局号码格式（国内号码），如：+86138\*\*\*\*0021或+8675528\*\*\*\*01。                                                                                                     |
| numberType     | 是    | Integer    | 号码类型 1：手机号 2：固话号码                                                                                                          |
| name           | 是    | String(50) | 号码类型是手机号(numberType=1)，号码所属人姓名 号码类型是固话号码(numberType=2)，经办人姓名                                                                                                           |
| identityCard   | 是    | String(20) | 号码类型是手机号(numberType=1)，号码所属人身份证号码 号码类型是固话号码(numberType=2)，经办人身份证号码                                                                                                     |
| liveFaceImage  | 是    | String     | 号码类型是手机号(numberType=1)，号码所属人现场照片文件名(半身或者寸照的头像) 号码类型是固话号码(numberType=2)，经办人现场照片文件名(半身或者寸照的头像) 文件名支持jpg或png格式，文件名长度不超过64字符 |
| operatorNumber | 否    | String(20) | 经办人手机号码，号码类型是固话号码(numberType=2)时携带本参数 号码格式：填写为全局号码格式（国内号码），如：+86138\*\*\*\*0021                                                                                       |
   
#### 响应参数
表5响应结果参数 
| 参数名称          | 是否必选 | 参数类型                                                                  | 说明                              |
|:---|:---|:---|:---|
| result        | 否    | String                                                                | 值为"Add Successful."，响应码为200时携带。 |
| error_code    | 否    | String                                                                | 错误码，响应码不为200时携带。                |
| error_msg     | 否    | String                                                                | 错误描述，响应码不为200时携带。               |
| failedNumbers | 否    | [FailedNumber]\[\] | 报备失败的A号码列表。                     |
   
 表6FailedNumber定义 
| 参数名称       | 是否必选 | 参数类型       | 说明                                                                                                                |
|:---|:---|:---|:---|
| number     | 是    | String(20) | A号码。 号码格式：填写为全局号码格式（国内号码），如：+86138\*\*\*\*0021或+8675528\*\*\*\*01。 |
| failReason | 是    | String     | 失败原因描述。                                                                                                           |
   
#### 结果码说明
表7响应结果码 
| 响应码                                                                                                  | 返回值       | 英文描述                   | 说明       |
|:---|:---|:---|:---|
| 200                                                                                                  | -         | Success.               | 成功。      |
| 400        | PPT.0001  | Internal server error. | 系统内部错误。  |
| 400        | PPT.0002  | Invalid Parameter.     | 无效参数。    |
| 400        | PPT.00039 | Operation failed.      | 操作失败。    |
| 403                                                                                                  | PPT.0007  | Request unauthorized.  | 请求鉴权未通过。 |
   
#### 接口示例
- 请求示例
  ```
  POST  /v1.0/privatenumber/a-number
  {
      "numbers":[{"number":"+86185****6002", "numberType"：1, "name"："XXX", "identityCard"："XXXXXX",  "liveFaceImage"："XXX.png"}]
  }
  ```
  
- 响应示例
  ```
  成功：
  HTTP/1.1 200
  Content-Type: application/json;charset=UTF-8
  {
     "result": "Add Successful."  
  }
  失败：
  HTTP/1.1 400
  Content-Type: application/json;charset=UTF-8
  { 
    "error_code"："PPT.0007", 
    "error_msg"："Request unauthorized."
  }
  ```