上传A号码报备文件 - CreateReportFiles
接口功能
企业租户通过该接口上传号码所属人现场照片报备文件。
使用说明
前提条件:
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限管理。
URI
POST /v1/privatenumber/a-number/files
请求参数
| 参数名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 说明:
|
| 参数名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| agree_authorization_statement | 是 | Boolean | 是否同意个人数据授权声明。
|
| 参数名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
| files | 是 | MultipartFile[] | 号码所属人现场照片文件,支持jpg或png格式,单个文件最大支持32KB,最大支持10个文件,文件名全局保持唯一,文件名长度不超过64字符。 |
响应参数
| 参数名称 | 是否必须 | 参数类型 | 说明 |
|---|---|---|---|
| result | 否 | String | 值为"Upload Successful.",响应码为200时携带。 |
| error_code | 否 | String | 请求异常时返回的错误码,响应码不为200时携带。 |
| error_msg | 否 | String | 请求异常时返回的错误描述,响应码不为200时携带。 |
| failedFiles | 否 | 部分文件上传失败时,返回的失败文件列表。 |
结果码说明
| 响应码 | 返回值 | 英文描述 | 中文描述 | 处理方法 |
|---|---|---|---|---|
| 400 | PPT.0002 | Invalid Parameter. | 参数错误。 | 请检查请求参数填写是否正确。 |
| PPT.0009 | Order does not exist. | 服务未开通完成。 | 点击开通隐私号业务。 | |
| PPT.00032 | The operation is forbidden because tenant has been frozen. | 租户已被冻结,不能进行该操作。 | 请联系管理员处理。 | |
| PPT.00033 | The operation is forbidden because tenant has been restricted. | 租户受限,不允许操作。 | 请联系管理员处理。 | |
| PPT.00039 | Operation failed. | 操作失败。 | 请联系管理员处理。 | |
| 403 | PPT.00053 | The name of the uploaded file can contain up to 64 characters. | 上传文件名称长度最大支持64字符。 | 请修改文件名称的长度。 |
| 500 | PPT.0001 | Internal server error. | 内部服务错误。 | 请联系管理员处理。 |
接口示例
- 请求示例
POST /v1/privatenumber/a-number/files { "files": "/**/xxx.jpg" } - 响应示例
成功: { "result": "Upload Successful." } 失败: { "error_code":"PPT.0009","error_msg":"Order does not exist" }