创建邮件模板
接口说明
创建邮件模板,用于后续通过模板发送邮件。支持富文本编辑器和拖拽编辑器两种方式。
请求信息
- 获取公私钥:
ACCESSKEY_ID:ACCESSKEY_SECRET - 请求方法:
POST - 请求路径:
/api/v1/email/EmailTemplate - Content-Type:
application/json
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例值 |
|---|---|---|---|---|
| Name | string | 是 | 模板名称 | "欢迎邮件模板" |
| Subject | string | 是 | 邮件主题 | "欢迎加入USpeedo" |
| Abstract | string | 否 | 模板摘要 | "新用户欢迎邮件" |
| TriggerType | int | 是 | 触发类型:1-验证码/通知,2-营销推广类邮件 | 1 |
| Editor | int | 是 | 编辑器类型:1-富文本编辑器,2-拖拽编辑器 | 1 |
| HtmlContent | string | 是 | HTML邮件内容 | "邮件内容" |
| JsonContent | string | 否 | JSON格式内容(拖拽编辑器使用) | - |
| MaterialMD5 | array | 否 | 素材MD5列表 | ["md5_1", "md5_2"] |
| VariableAttr | string | 否 | 模板变量属性 | - |
| InTask | bool | 否 | 是否在任务中创建 | false |
注意事项
- TriggerType: 1表示验证码/通知,2表示营销推广类邮件
- Editor: 1表示使用富文本编辑器,2表示使用拖拽编辑器
- 使用拖拽编辑器时,需要提供
JsonContent字段 MaterialMD5用于关联邮件中使用的素材资源
请求示例
curl -X POST "https://api.uspeedo.com/api/v1/email/EmailTemplate" \
-H "Content-Type: application/json" \
-H "Authorization: Basic $(echo -n 'ACCESSKEY_ID:ACCESSKEY_SECRET' | base64)" \
-d '{
"Name": "欢迎邮件模板",
"Subject": "欢迎加入USpeedo",
"Abstract": "新用户欢迎邮件",
"TriggerType": 1,
"Editor": 1,
"HtmlContent": "<html><body><h1>欢迎</h1><p>亲爱的{name},欢迎加入USpeedo!</p></body></html>"
}'
响应格式
成功响应
{
"RetCode": 0,
"Message": "success",
"TemplateId": "template_123456"
}
响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| RetCode | int | 返回码,0表示成功 |
| Message | string | 返回消息 |
| TemplateId | string | 创建的模板ID,用于后续发送邮件 |
失败响应
{
"RetCode": 215392,
"Message": "Invalid parameter [Name]"
}