UpdateSmsSignature - 更新存量签名材料--短信服务-火山引擎

文档中心

立即注册

导航

UpdateSmsSignature - 更新存量签名材料

最近更新时间：2025.06.13 15:08:01首次发布时间：2025.06.13 15:08:01

-为适配运营商关于短信签名实名制的改造要求，该接口可以更新历史签名的APPICP备案、商标证书等材料，这些材料将用于用于辅助运营商进行签名实名审核

请求说明

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

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
涉及图片/文件上传的部分，请确保单个图片/文件小于5M，防止由于文件过大产生上传超时的问题。

参数	类型	是否必填	示例值	描述
Action	String	是	UpdateSmsSignature	要执行的操作，取值：UpdateSmsSignature。
Version	String	是	2021-01-11	API的版本，取值：2021-01-11。
source	Integer	是	1	签名类型。可取值的： 1.公司全称/简称； 2.APP全称； 3.商标全称
content	String	是	签名	签名内容
desc	String	否	描述	申请说明描述
scene	String	否	验证码	业务场景描述
domain	String	否	http://url.com	工信部备案网站
purpose	Integer	否	1	签名用途； 1. 自用，2. 他用
signatureIdentificationID	Integer	否	12	实名资质id（不传的情况如果历史未绑定将会返回错误）
uploadFileList	Array of Object	否		其他的相关证明文件，填入值时会覆盖历史值
appIcp	Object	否		APPICP 相关信息，非必填，填入值时会覆盖历史值
trademark	Object	否		商标相关信息，非必填，填入值时会覆盖历史值

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
signature	String	签名	签名
createdTime	Integer	1749634580	创建时间

请求示例

POST /?Action=UpdateSmsSignature&Version=2021-01-11 HTTP/1.1
Host: https://sms.volcengineapi.com/UpdateSmsSignature
Content-Type: application/json; charset=UTF-8
X-Date: 20250609T072533Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250609/cn-beijing/volcSMS/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "source": 535,
  "content": "D7okh",
  "desc": "DcGC",
  "scene": "8d9wt7wOJk",
  "domain": "AOdtiibx",
  "purpose": 1,
  "signatureIdentificationID": 637,
  "uploadFileList": [
    {
      "fileContent": "data:image/jpg;base64,IPV*****************************************************************CYII=",
      "fileSuffix": "jpg",
      "fileUrl": "bQIET",
      "fileType": 0
    }
  ],
  "appIcp": {
    "appIcpFilling": "V2",
    "appIcpFileList": []
  },
  "trademark": {
    "trademarkCn": "y3TUNXvACYj",
    "trademarkEn": "DN",
    "trademarkNumber": "xoFqLn7",
    "trademarkFileList": []
  }
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250609152544178191242198CEF678",
    "Action": "UpdateSmsSignature",
    "Version": "2021-01-11",
    "Service": "volcSMS",
    "Region": "cn-beijing"
  },
  "Result": {
    "signature": "eb8djvV",
    "createdTime": 593
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	1001	参数错误或其它具体描述	参数错误，具体错误原因参见错误信息描述
200	1999	系统错误	系统错误