Отправка транзакционных рассылок

Такие рассылки отправляются индивидуально каждому получателю через API-запрос. Чаще всего в рассылки передаются переменные, которые подставляются в контент письма.

POST https://api.rees46.ru/transact

Параметры

Параметр	Обязателен?	Описание
shop_id	Да	API-ключ
shop_secret	Да	Секретный ключ API
code	Да	Уникальный код транзакционной рассылки
email*	Да	Email клиента
phone*	Да	Телефон клиента
external_id*	Да	Внешний ID клиента
loyalty_id*	Да	Идентификатор ПЛ клиента
telegram_id*	Да	Telegram ID клиента
variables	Нет	Объект с переменными, которые подставляются в текст сообщения. Рекомендуем использовать плоский объект без вложенных объектов
test	Нет	Флаг отправки тестового письма. Если указан в 1 или true, то письмо отправляется, но не получает уникальный код и для него не учитываются открытия, клики, баунсы и другие действия получателя
cc	Нет	Адреса электронной почты для получения копии письма в виде массива
bcc	Нет	Адреса электронной почты для получения скрытой копии письма в виде массива

Идентификаторы

Параметры, отмеченные [*] - обязателен хотя бы один из них. Даже если вы отправляете рассылку на email, вы можете передать phone, если уверены, что у клиента есть и email и phone (часто phone есть у 100% клиентов, а email не у всех). В том числе это решает проблему отправки мобильного пуша.

Запрос

Пример запроса:

JSON

curl --header "Content-Type: application/json" \
  --request POST \
  --data-binary "@payload.json" \
  https://api.rees46.ru/transact

FormData

curl --location --request POST 'https://api.rees46.ru/transact' \
--form 'shop_id="SHOP_ID"' \
--form 'shop_secret="SHOP_SECRET"' \
--form 'code="TRANSACTIONAL_MESSAGE_CODE"' \
--form 'email="EMAIL"' \
--form 'variables[KEY]="VALUE"'
--form 'variables[KEY_2]="VALUE_2"'

Пример JSON-тела:

{
    "shop_id": "...",
    "shop_secret": "...",
    "phone": "7XXXXXXXXX",
    "code": "password-restore",
    "variables": {
      "2fa_code": "...",
      "first_name": "...",
      "last_name": "..."
    }
}

Ответ

Пример ответа сервера:

{
  "success": true,
  "payload": {
    "code": "..."
  }
}

Расшифровка ответа:

Параметр	Описание
success	Запрос выполнен успешно или нет
payload	Тело ответа
payload.code	Уникальный код сообщения, по которому потом можно проверять статусы доставки и другие показатели

В случае ошибки ответ будет в формате:

{
  "success": false,
  "payload": {
    "message": "Shop not found"
  }
}