Псевдоним шаблона

У каждого шаблона в Haskimail есть псевдоним (алиас). По нему удобно ссылаться на шаблон при отправке вместо числового ID: псевдоним понятнее и его проще использовать в коде. Задать псевдоним можно в интерфейсе или через API шаблонов.

Установка псевдонима через интерфейс Haskimail

1. Откройте шаблон.

2. Нажмите на текущий псевдоним.

3. Введите новый псевдоним, например welcome_new.

Важно: если вы меняете псевдоним, обновите его и в коде приложения, которое отправляет письма с этим шаблоном.

Установка псевдонима через API шаблонов

Чтобы задать псевдоним, отправьте запрос PUT https://api.haskimail.ru/templates/{templateIdOrAlias} с серверным ключом в заголовке X-Haskimail-Server-Token. Метод перезаписывает шаблон целиком, поэтому передайте все поля шаблона — Name, Subject, HtmlBody, TextBody — и новый Alias. Пропущенные поля станут пустыми.

Пример:

{
  "Name": "Приветствие",
  "Alias": "my-alias",
  "Subject": "Добро пожаловать, {{name}}!",
  "HtmlBody": "<p>Здравствуйте, {{name}}!</p>",
  "TextBody": "Здравствуйте, {{name}}!"
}

Теперь при отправке письма можно указывать псевдоним в поле TemplateAlias вместо TemplateId. Ключи в TemplateModel — это переменные вместе с фигурными скобками.

Пример:

{
  "TemplateAlias": "my-alias",
  "TemplateModel": { "{{name}}": "Иван" },
  "From": "sender@example.com",
  "To": "receiver@example.com"
}