跳到主要内容

创建短信模板接口

温馨提示
  • 模板如需变量,请在响应内容位置点插入变量,最多支持 10 个变量
  • 内容如有链接,请在链接前后添加空格
  • 审核时间:每日9:00~18:00期间提交 预计 30 分钟内完成审核,如需加急可联系在线商务处理

短信模板分为 固定内容模板携带变量模板

  • 固定内容模板 适用于给不同用户发送相同内容 如优惠活动等。
  • 携带变量模板 适用于给不同用户发送不同的内容 如验证码通知等。

请求说明

  • 接口请求域名 : api.ffrcs.cn
  • RequestURI : /rest/sms/v3/template/add
  • Method : POST
  • Content-Type : application/json; charset=utf-8;

默认接口请求频率限制:2次/秒。

输入参数

参数类型描述示例必填
templateNameString模板名称测试
templateContentString模板内容(无需携带签名)。
如携带变量,按指定格式{1},{2}...{10}插入
示例1:欢迎使用飞鱼云通信。
示例2:尊敬的{1}:您的验证码是{2}。
smsTypeInteger短信类型。
10000-验证码&通知
10001-营销短信
10000
remarkString模板备注。例如申请原因,使用场景等。业务验证码

响应内容

参数类型描述
codeInteger响应状态
messageString响应状态描述
dataObject数据节点
data.templateIdInteger返回的短信模板ID

示例

请求示例

curl  'https://api.ffrcs.cn/rest/sms/v3/template/add' \
--header 'Content-Type: application/json' \
--header 'X-FZ-Timstamp: 1713152159772 ' \
--header 'Authorization: HmacSHA256 credential=1kl***,signature=1264b693*******be05bef' \
--data '{
"templateName": "验证码",
"templateContent":"您好,您的验证码是{1},有效期10分钟。",
"smsType": 10000,
"remark": "业务验证码"
}'

响应示例

{
"msg": "成功",
"code": "ok",
"data": {
"templateId": 1
}
}

错误码参考- 错误码