删除A号码报备信息 - DeletePvCallerNumber

接口功能

企业用户通过该接口删除租户A号码报备信息。

使用说明

仅使用隐私号业务的用户可调用此接口。

授权信息

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

URI

DELETE /v1.0/privatenumber/a-number

接口类型

表1 接口类型说明
请求方法	DELETE
访问URI	/v1.0/privatenumber/a-number
通信协议	HTTPS

请求参数

表2 请求Headers参数说明
参数名称	是否必选	参数类型	说明
Content-Type	否	String	参数解释：消息体的类型（格式）。约束限制：不涉及。取值范围：固定填写为application/json;charset=UTF-8。默认取值：不涉及。
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。说明： Token的有效期为24小时，到期后请重新获取。使用AKSK鉴权不需要携带此参数。

表3 请求Body参数说明
参数名称	是否必选	参数类型	说明
numbers	是	String[]	A号码，最多10个。号码格式：填写为全局号码格式（国内号码），如：+86138**0021或+8675528**01。

响应参数

表4 响应结果参数
参数名称	是否必选	参数类型	说明
result	否	String	值为"Delete Successful."，响应码为200时携带。
error_code	否	String	错误码，响应码不为200时携带。
error_msg	否	String	错误描述，响应码不为200时携带。

结果码说明

表5 响应结果码
响应码	返回值	英文描述	说明
200	-	Success.	成功。
400	PPT.0001	Internal server error.	系统内部错误。
	PPT.0002	Invalid Parameter.	无效参数。
	PPT.0009	Order does not exist.	订单不存在。
	PPT.00039	Operation failed.	操作失败。
403	PPT.0007	Request unauthorized.	请求鉴权未通过。

接口示例

请求示例

DELETE /v1.0/privatenumber/a-number 
{     
   "numbers":["+86185****6002"]
}

响应示例

成功：
HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8 
{
    "result": "Delete Successful."
}
失败：
HTTP/1.1 403
Content-Type: application/json;charset=UTF-8
{
   "error_code":"PPT.0007",
   "error_msg": "Request unauthorized."
}

父主题： A号码报备接口

上一篇：查询A号码报备信息-QueryPvCallerNumber

下一篇：附录