Fecify-邮件模版-保存

邮件模版-保存

接口信息

  • 接口地址: {your-site-url}/api/skill/notice/email-update
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: POST
  • Content-Type: application/json
  • 配对接口: 邮件模版-详情
  • 使用流程: 先调用详情接口获取当前模版内容 → 修改 subject 和 body_html → 调用本接口更新
  • 说明: 更新指定邮件模版的标题和 HTML 内容。模版中的 Liquid 变量将被实际数据替换后发送。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数

字段 类型 必填 说明
id String 是 邮件模版 ID，从 邮件模版-列表 获取
subject String 是 邮件模版标题
body_html String 是 邮件模版 HTML 内容，可使用 邮件模版-详情 返回的 liquid_variables 中列出的变量

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/notice/email-update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "2507",
    "subject": "Activate your merchant account",
    "body_html": "<table>...</table>"
}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "id": 2507,
        "shop_id": 0,
        "status": 1,
        "lang_code": "default",
        "type": 3,
        "category": 1,
        "subject": "Activate your merchant account",
        "body_html": "<table>...</table>",
        "note": "商家注册账号，通过邮件发送激活账户的链接",
        "created_at": "2024-07-07 21:55:10",
        "updated_at": "2024-07-07 21:55:10"
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Object 更新后的邮件模版完整信息

data 子字段

字段 类型 说明
id Number 邮件模版唯一 ID
shop_id Number 店铺 ID，0 表示全局模版
status Number 邮件模版状态：1 = 开启，2 = 关闭
lang_code String 语言简码，default 表示默认语言
type Number 邮件类型 ID
category Number 邮件分类 ID
subject String 邮件模版标题
body_html String 邮件模版 HTML 内容
note String 邮件使用场景描述
created_at String 创建时间
updated_at String 最后更新时间

注意事项

  1. 先通过 邮件模版-详情 获取当前模版内容，修改 subject 和 body_html 后再调用本接口。
  2. body_html 为完整的 HTML 内容，请确保 Liquid 变量（如 `）语法正确，仅使用liquid_variables` 中列出的变量。
  3. 更新成功后可在 邮件模版-测试发送 中测试邮件效果。

results matching ""

    No results matching ""