Наполнение рассылки сообщениями

Наполнение рассылки

POST https://direct.i-dgtl.ru/api/v1/dispatch/{dispatchId}/messages

Path Parameters

Name	Type	Description
dispatchId*	integer	Идентификатор рассылки

Headers

Name	Type	Description
Authorization*	string	Basic {TOKEN_1}
Content-Type*	string	application/json

Request Body

Name	Type	Description
destination*	string	Номер абонента
substitutions	object	Подстановки для текста рассылки

200

Возвращаются идентификаторы успешно созданных, а также коды ошибок неуспешных сообщений.

[
  {
    "destination": "79818269375",
    "messageUuid": "uuid"
  },
  {
    "destination": "79818228228",
    "errorCode": 7401
  }
]

401

403

Проверка уникальности destination в рамках одной рассылки не выполняется

В одном запросе можно передать не более 1000 сообщений

Рекомендуемое время ожидания ответа: 70 секунд. Как правило, ответ на запрос возвращается не более чем за несколько секунд, но таймаут величиной в 70 секунд позволяет гарантированно получить ответ на запрос, в том числе в ситуациях повышенной нагрузки.

Подстановки

Ключи объекта substitutions должны соответствовать переменным в тексте рассылки.

Текст рассылки:

"Уважаемый {{A}}! Рады сообщить, что Вам одобрена кредитная карта на сумму {{B}}, можете забрать ее в ближайшем офисе по адресу {{C}}."

Объект подстановок:

"substitutions": {
    "A": "Сергей Алексеевич",
    "B": "100 тыс. руб.",
    "C": "Санкт-Петербург, Большой проспект П.С., 12"
    }

При отсутствии подстановок в тексте рассылки, объект substitutions будет проигнорирован.

Коды ошибок

• При отсутствии хотя бы одной подстановки для сообщения - 7401

• При невалидном номере абонента - 7402

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

JSON

POST https://direct.i-dgtl.ru/api/v1/dispatch/10000000125/messages
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
[
  {
    "destination": "79818269375",
    "substitutions": {
    "A": "Сергей Алексеевич",
    "B": "100 тыс. руб.",
    "C": "Санкт-Петербург, Большой проспект П.С., 12"
    }
  },
  {
    "destination": "79818228228",
    "substitutions": {
      "A": "Алексей Сергеевич",
      "B": "1000 рублей"
    }
  }
]

cURL

Для запуска рассылки необходимо выполнить третий шаг, описанный здесь.