文档首页/ 消息&短信 MSGSMS/ API参考/ API/ 应用、签名、模板/ 短信模板/ 修改短信模板
更新时间：2025-09-25 GMT+08:00
查看PDF
分享

修改短信模板

功能介绍

该接口用于用户修改模板信息，目前支持审核不通过的短信模板重新修改、支持审核通过的模板停用后重新修改、支持待审核或待签名审核的模板撤回模板申请后重新修改。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

PUT /v2/{project_id}/msgsms/templates/{id}

表1 路径参数

参数

是否必选

参数类型

描述

id

是

String

模板主键ID，对应表5中的ID

project_id

是

String

项目ID，参考“获取帐号、用户、项目的名称和ID”

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

请求体参数类型，该字段必须设置为：application/json

X-Auth-Token

是

String

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）
表3 请求Body参数

参数

是否必选

参数类型

描述

app_id

是

String

应用主键ID，参考表5 响应SmsAppQueryResp参数中的ID

brackets

否

String

中括号类型。支持枚举值：

  • CN：中文类型【】
  • GB：英文类型[]
    须知：
    • 默认值为：CN
    • 输入值不在上述枚举值范围内的，也按CN处理。
    • 只有地域为国内时，该字段有效。

region

是

String

地域

  • cn：国内
  • intl：国际

send_country

否

Array of Integers

发送国家ID列表，只有地域为国际时，该字段有效

sign_id

否

String

签名ID，对应表5 响应SmsSignatureResp参数中的ID。只有地域为国内时，该字段有效

template_content

是

String

模板内容

template_desc

否

String

模板描述

template_name

是

String

模板名称

template_type

是

String

模板类型。只有地域为国内时，该字段有效。支持枚举值：

  • VERIFY_CODE_TYPE：验证码类
  • PROMOTION_TYPE：推广类
  • NOTIFY_TYPE：通知类

universal_template

否

Integer

是否为通用模板

  • 0：非通用模板
  • 1：通用模板

variable_attributes

否

Array of SmsTemplateVariableAttrReq objects

模板参数

flow_status

否

String

流程状态

  • Pending：待提交
  • Reviewing：待审核
  • Disable：停用
表4 SmsTemplateVariableAttrReq

参数

是否必选

参数类型

描述

variable_desc

否

String

变量说明，当变量类型为TEXT时，必填

variable_index

是

Integer

变量索引，对应模板内容变量索引

variable_type

是

String

变量类型

  • PHONE：电话号码
  • CHARDIGIT：其他号码（如验证码、订单号、密码等）
  • DATETIME：日期时间
  • MONEY：金额
  • TEXT：其他（如名称、帐号、地址等）

响应参数

状态码： 200

表5 响应Body参数

参数

描述

id

模板主键ID

template_name

模板名称

请求示例

修改短信模板，请求方式：PUT ，请求URL：/v2/{project_id}/msgsms/templates/{id}，路径参数：id，project_id，请求头参数：X-Auth-Token，Content-Type，请求体：app_id，region，template_content，template_name，template_type。

PUT /v2/845ada5bc7444f1295cd517af0123da1/msgsms/templates/c3f641aa-4e87-4a70-b84d-a2d685599072 HTTP/1.1
Host: 100.85.***.***:30300
Content-Type: application/json
X-Auth-Token: ***
Content-Length: 311
 
{
       "app_id": "******9c-1a6b-4ee5-9651-5bca450694b3",
       "brackets": "GB",
       "region": "cn",
       "sign_id": "******58-e866-4b30-9ca5-a476a00e8775",
       "template_content": "测试",
       "template_name": "auto_test000",
       "template_type": "NOTIFY_TYPE",
       "universal_template": 0
}

响应示例

{
    "id": "******aa-4e87-4a70-b84d-a2d685599072",
    "template_name": "auto_test000"
}

返回值

返回值

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

500

System error
父主题： 短信模板

相关文档