文档首页/ 隐私保护通话 PrivateNumber/ API参考/ API/ A号码报备接口/ 上传A号码报备文件-CreateReportFiles
更新时间:2026-07-29 GMT+08:00
分享

上传A号码报备文件 - CreateReportFiles

接口功能

企业租户通过该接口上传号码所属人现场照片报备文件。

使用说明

前提条件:

  1. 获取用户Token或已获取AK(Access Key ID)/SK(Secret Access Key)。
  2. 开通隐私号业务
  3. 请根据业务的预计使用情况准备企业相关报备信息,详细内容可参照下表的材料说明。企业报备材料通过本接口上传。
    表1 租户级A号码报备材料

    名称

    规范性要求

    号码所属人现场照片

    号码所属人现场照片,半身或者寸照的头像,照片jpg或png格式,32KB以下。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限管理

URI

POST /v1/privatenumber/a-number/files

请求参数

表2 请求Headers参数说明

参数名称

是否必选

参数类型

说明

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

说明:
  • Token的有效期为24小时,到期后请重新获取。
  • 使用AKSK鉴权不需要携带此参数。
表3 请求URL参数说明

参数名称

是否必选

参数类型

说明

agree_authorization_statement

Boolean

是否同意个人数据授权声明。

  • true:同意。
说明:
  • “A号码报备文件上传”操作会收集您的现场照片信息,该信息属于敏感个人信息,仅用于隐私号业务向运营商报备号码,如果非本人操作,请确定已获得相应授权。
  • 如果不同意个人数据授权声明,上传文件会失败。
  • 点击查看隐私政策声明服务使用声明
表4 请求Body参数说明

参数名称

是否必选

参数类型

说明

files

MultipartFile[]

号码所属人现场照片文件,支持jpg或png格式,单个文件最大支持32KB,最大支持10个文件,文件名全局保持唯一,文件名长度不超过64字符。

响应参数

表5 响应结果参数

参数名称

是否必须

参数类型

说明

result

String

值为"Upload Successful.",响应码为200时携带。

error_code

String

请求异常时返回的错误码,响应码不为200时携带。

error_msg

String

请求异常时返回的错误描述,响应码不为200时携带。

failedFiles

FailedFile[]

部分文件上传失败时,返回的失败文件列表。

表6 FailedFile定义

参数名称

是否必选

参数类型

说明

file

String(64)

文件名。

failReason

String

失败原因描述。

结果码说明

表7 响应结果码

响应码

返回值

英文描述

中文描述

处理方法

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"
    }

相关文档