删除短信签名-DeleteSignature--短信服务-火山引擎

文档中心

立即注册

导航

删除短信签名-DeleteSignature

最近更新时间：2025.10.13 22:41:04首次发布时间：2023.01.17 16:19:49

短信服务使用方可调用DeleteSignature接口，

删除已审核通过/审核不通过的签名，
撤销申请中的签名。

请求说明

请求方式：POST
接口地址：https://sms.volcengineapi.com/?Action=DeleteSignature&Version=2021-01-11

请求参数

Query

名称	类型	是否必填	示例值	描述
Action	String	是	DeleteSignature	要执行的操作，取值：DeleteSignature
Version	String	是	2025-01-01	API的版本，取值：2025-01-01

Body

名称	类型	是否必填	示例值	描述
subAccount	String	是	A123****	消息组ID
id	Integer	是	169000	签名ID或申请签名工单的ID
isOrder	Boolean	是	false	删除对象是否是审核工单。true适用于签名审核状态为“审核中”
subAccounts	Array of String	是	[a123,b332]	消息组ID列表
signature	String	是	签名	需要删除的签名

响应数据

名称	类型	示例值	描述
ResponseMetadata	ResponseMetadata		响应公共参数
Result	String		响应业务参数，没有错误时返回""

示例

成功请求示例

请求

{
    "subAccount":"6df8****",
    "id":1***0,
    "isOrder":false
}

响应

{
    "ResponseMetadata":{
        "RequestId":"202209131145550101500980291952****",
        "Action":"DeleteSignature",
        "Version":"2021-01-11",
        "Service":"volcSMS",
        "Region":"cn-north-1"
    },
    "Result":""
}

失败请求示例

请求

{
    "subAccount":"6df8****",
    "id":1***0,
    "isOrder":true
}

响应

{
    "ResponseMetadata":{
        "RequestId":"202209131146500101500980291D4F****",
        "Action":"DeleteSignature",
        "Version":"2021-01-11",
        "Service":"volcSMS",
        "Region":"cn-north-1",
        "Error":{
            "Code":"1005",
            "Message":"status is not reviewing"
        }
    }
}

错误码

下表提供了该接口业务逻辑相关的错误码。公共错误码请参见公共错误码。

HttpCode	错误码	错误信息	描述
200	1001	参数错误	参数错误
200	1005	status is not reviewing	关闭申请工单时，不是未审核状态
200	1999	系统错误	系统错误
200	1006	not existed	删除时，Id找不到