Telnyx Email API теперь предоставляет разработчикам больше контроля над тем, как шаблоны Liquid обрабатывают переменные и отображаемый контент. Новые параметры проверки, значений по умолчанию и автоматического экранирования помогают сделать динамические шаблоны электронных писем более безопасными и предсказуемыми.
Что нового
- Проверка обязательных переменных: объявите обязательные переменные в variable_schema, а затем включите strict_variables. Отсутствующие или пустые обязательные значения приводят к сбою рендеринга и отправки с ответом 422. Параметр strict_variables сам по себе не определяет требования на основе шаблона.
- Необязательные значения переменных по умолчанию: определите строковые значения по умолчанию для необязательных переменных в variable_schema; значения, предоставленные вызывающей стороной, имеют приоритет. Для обязательных переменных нельзя задавать значения по умолчанию.
- Автоматическое экранирование HTML: включите autoescape для HTML-экранирования вывода динамических выражений Liquid в html_body. Вывод темы (subject) и текстового тела (text-body) не экранируется автоматически.
Почему это важно
Динамические шаблоны часто зависят от данных, предоставляемых во время отправки. Эти обновления дают разработчикам больше контроля над тем, что происходит при отсутствии переменных и как отображается динамический контент.
Проверка обязательных переменных позволяет обнаружить отсутствие данных до того, как шаблон будет обработан или отправлен, а значения по умолчанию в схеме предоставляют данные для пропущенных необязательных переменных. Автоматическое экранирование HTML-тела снижает риск того, что динамические значения будут интерпретированы как разметка, не затрагивая при этом литеральный HTML шаблона, темы или текстовые тела.
Начало работы
Предварительные требования
- Учетная запись Telnyx
- API-ключ с портала Telnyx
- Шаблон Email API, использующий переменные Liquid
Шаблоны электронных писем Telnyx поддерживают переменные Liquid в теме, HTML и текстовом контенте, их можно визуализировать и просматривать перед отправкой.
Узнайте больше в документации по шаблонам электронной почты (Email Templates).
