Быстрый старт#

Отправка почтового сообщения#

Подготовка хранилища формата р12#

1. Добавление в хранилище ключевой пары

openssl pkcs12 -export -out [keystore name].p12 -inkey [key file].pem -in [cert file].pem

Примечание: Требования к созданию ключа и сертификата не регламентируется.

2. Добавление в хранилище сертификатов УЦ

keytool -importcert -noprompt -keystore [keystore name].p12 -storepass [keystore pass] -alias [name of cert in keystore] -file [cert file to import].pem

3. Итоговый результат (на скриншоте файл открыт с помощью KeyStore Explorer): Хранилище содержит ключевую пару и доверенный сертификат.

Проверка запроса в Insomnia#

Быструю проверку метода можно провести с помощью программы Insomnia.

Создать коллекцию запросов#

Для создания запроса, предварительно необходимо создать коллекцию запросов. Для создания коллекции запросов:

1. Нажмите кнопку Create.

2. Выберите пункт Request Collection в выпадающем списке.

Для защищенного соединения, необходимо использовать ранее созданное хранилище p12, выбранное в Collection Settings.

Создание нового запроса#

Для создания нового запроса:

1. Перейдите в коллекцию.

2. Нажмите комбинации клавиш Command+N для MacOS.

3. В открывшемся окне укажите метод - Post и формат данных для тела запроса - JSON.

4. В поле вызова метода введите:

https://mailhost.ru/send

где mailhost.ru - ваш адрес установленного продукта.

5. Заполните тело запроса в JSON:

{
"bodyType": "text/plain",
"importance": "high",
"to": [
    "test@domain.ru"
],
"subject": "test",
"body": "test",
"secret": "SECRET",
"isNeedToSaveSent": false,
"messageId": "qwerty"
}

Подробнее о параметрах запроса описано в разделе «Использование программного компонента» документа «Руководство прикладного разработчика».

6. Заполните заголовки в разделе Header:

7. Нажмите кнопку Send, для отправки запроса. Пример ответа:

Основной код может быть равен 0 или -1, где 0 - нет ошибок, -1 - есть ошибка

Код в поле data: