Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод getActualMessageVersion

В кабинете UniSender реализована версионность писем. Ранее отправленное письмо можно отредактировать, или изменить список отправки, при этом будет создана новая версия письма. Версия — это message_id, который передается при создании рассылки (метод createCampaign). Актуальная версия может быть только одна. В интерфейсе кабинета можно указать, какую версию считать актуальной. При создании рассылок с помощью API версионности нет: при редактировании письма, которое ранее не отправлялось в рассылках (метод updateEmailMessagemessage_id не меняется; при редактировании письма, которое ранее отправлялось, результатом вызова метода updateEmailMessage будет письмо с новым id.

Поскольку пользователи могут пользоваться и API-интеграцией, и кабинетом UniSender, возникают ситуации, когда пользователи в кабинете создают новые версии письма. Поскольку отправка на неактуальные версии письма невозможна, то при попытке использования message_id неактуальной версии письма пользователю будет возвращена ошибка: «error»: «Unable to create campaign. The letter has a new version (12345678)».

Метод getActualMessageVersion возвращает id актуальной версии заданного письма.

Принцип использования

Синтаксис и URL для вызова метода
getActualMessageVersion (int message_id)
https://api.unisender.com/ru/api/getActualMessageVersion?api_key=KEY&message_id=ID
Аргументы
api_key * Ключ доступа к API
message_id * Идентификатор сообщения, для которого необходимо получить id актуальной версии письма
Возвращаемое значение
Пример возвращаемого значения при удачном выполнении запроса:

{
  "result": {
    "message_id": 61312345,
    "actual_version_id": 62814234
  }
}

Где:
message_id — id письма, для которого был получен id актуальной версии письма

actual_version_id — id актуальной версии письма

Пример возвращаемого значения при ошибке:

{"error":"error message", "code":"error code"}