Подпись отправителя — это email-адрес, который будет отображаться в поле «От кого». Haskimail позволяет отправлять письма только с предварительно подтвержденных email-адресов. Обычно достаточно создать одну или две подписи отправителя на сайте Haskimail, и их хватит на все время использования аккаунта. Однако мы в Haskimail понимаем, что это подходит не всем нашим пользователям. Например, если вы хотите отправлять письма с большого количества адресов или динамически создавать подписи отправителей, участие человека в процессе становится непрактичным. Именно поэтому мы предоставляем RESTful API, с помощью которого наши клиенты могут программно управлять подписями отправителей через эндпоинт /senders. Для получения полной информации об этом эндпоинте, пожалуйста, обратитесь к справочнику по API подписей отправителей.
Мы рекомендуем подтверждать домен, так как это самый быстрый способ обеспечить доставляемость писем. Настройка аутентификации DKIM и Return-Path не является абсолютно обязательной при создании подписи отправителя, но мы настоятельно рекомендуем ее внедрить для обеспечения доставляемости и безопасности.
Создание подписи отправителя должно быть довольно простым для тех, кто знаком с использованием API. Полный справочник по API содержит все детали. Ниже обсуждаются некоторые важные моменты.
Аутентификация
Подписи отправителей принадлежат аккаунту. Это отличается от того, к чему вы могли привыкнуть при отправке писем, которые в Haskimail принадлежат отдельному серверу. Для управления подписями отправителей вам понадобится токен API аккаунта. Его может получить только владелец аккаунта на вкладке «Токены API» в личном кабинете Haskimail. Этот токен используется как значение HTTP-заголовка X-Haskimail-Account-Token. Этот HTTP-заголовок должен использоваться для аутентификации всех API-запросов к эндпоинту /senders. Если возникнет проблема с аутентификацией, вы получите HTTP-ответ со статус-кодом 401 (Unauthorized).
Обязательные поля
Для создания подписи отправителя требуются всего две части информации. 1). FromEmail — это email-адрес, который будет отображаться в поле «От кого» в отправляемых вами письмах. Это должен быть реально существующий почтовый ящик. Haskimail отправит письмо-подтверждение, которое необходимо подтвердить, прежде чем вы сможете использовать подпись отправителя. 2). Кроме того, это должен быть частный домен, к которому у вас есть доступ. Это необходимо по двум причинам. Во-первых, отправка писем Haskimail с домена, который вы не контролируете (например, Gmail или Yahoo), может расцениваться как email-спуфинг. Yahoo, в частности, опубликовала политику, запрещающую сторонним сервисам отправлять письма с адресов @yahoo.com. Во-вторых, у вас должна быть возможность изменять DNS-записи для добавления поддержки SPF и DKIM, которые настоятельно рекомендуются для повышения доставляемости писем.
Поле Name также является обязательным при создании подписи отправителя. Это то, что большинство почтовых клиентов отобразят в поле «От кого». Хотя оно обязательно при создании подписи, его можно переопределить в каждом отдельном запросе. Если вы создадите подпись отправителя для «Nick <support@yourdomain.com>», вы также сможете отправлять письма от имени «Joe <support@yourdomain.com>» без каких-либо дополнительных настроек.
Поля ответа
Полный список полей ответа находится здесь, но ниже приведены те поля, которые помогут вам в дальнейшей работе с подписями отправителей.
Конечно, создание подписи отправителя — это лишь часть полного рабочего процесса. Используя эндпоинт API /senders, вы можете получать списки, редактировать или удалять свои подписи отправителей. Вы даже можете повторно отправить письмо-подтверждение, проверить SPF и запросить новые DKIM-ключи.
