创建短信模板接口
温馨提示
- 模板如需变量,请在响应内容位置点插入变量,最多支持 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次/秒。
输入参数
参数 | 类型 | 描述 | 示例 | 必填 |
---|---|---|---|---|
templateName | String | 模板名称 | 测试 | 是 |
templateContent | String | 模板内容(无需携带签名)。 如携带变量,按指定格式{1},{2}...{10}插入 | 示例1:欢迎使用飞鱼云通信。 示例2:尊敬的{1}:您的验证码是{2}。 | 是 |
smsType | Integer | 短信类型。 10000-验证码&通知 10001-营销短信 | 10000 | 是 |
remark | String | 模板备注。例如申请原因,使用场景等。 | 业务验证码 | 否 |
响应内容
参数 | 类型 | 描述 |
---|---|---|
code | Integer | 响应状态 |
message | String | 响应状态描述 |
data | Object | 数据节点 |
data.templateId | Integer | 返回的短信模板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
}
}
错误码参考- 错误码