{"info":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","description":"

API-документация российского SMTP-сервиса СамОтправил. Сервис ориентирован на интеграцию с SaaS-решениями. Рекомендуем ознакомиться с особенностями интеграции. Также вы можете обсудить интеграцию с нашими специалистами.

Готовые библиотеки

Python. Автор: Команда SamOtpravil
\n
PHP. Автор: Константин Пензин
\n
Ruby. Автор: Сообщество Rubyschool
\n

Авторизация

Авторизация происходит через использование API-ключа в заголовке Authorization: {{api_key}}

Чтобы получить API ключ к SMTP методам, отправьте запрос.

Лимиты

Лимиты на запросы

К SMTP можно обращаться не более 10 000 раз в минуту.

В случае превышения лимита, вы получите ошибку с кодом 429.
{\"status\":\"throttling\",\"error\":\"Request was throttled. Expected available in 1 second.\"}
Напишите нам, если требуется увеличить лимит.

Среднее время выполнения одного запроса 500мс.

Лимиты на отправки

Все рассылки при создании имеют ограничение 100 писем \\ 5 минут

При превышении лимита, вы получите ошибку 450 ratelimit exceeded
Напишите в поддержку, чтобы увеличить лимит.

Лимиты на создание пакетов

Все рассылки при создании имеют ограничение 40 пакетов \\ 5 минут

При превышения лимита, вы получите ошибку E429Напишите в поддержку, чтобы увеличить лимит.

Лимит на размер письма

Стандартный лимит на размер письма - 50mb

Настройки

SMTP сервер: api.samotpravil.ru
Порт: 1126 или 1127 (TLS)

Треккинг открытий и кликов

Для отслеживания кликов оберните все ссылки в в следующий редирект

[domain]/click/[X-Track-ID]?goto_url=[url]\n\n

Для отслеживания открытий добавьте следующую конструкцию в контент письма

img src=\"[domain]/open/[X-Track-ID]\" alt=\"\" height=\"1\" width=\"1\" border=\"0\"\n\n

X-Track-ID это ваш внутренний ID отправки, нужно также его передавать и в заголовок письма. Должен быть уникальным для каждой отправки.
Хорошая практика формирования X-Track-ID -

{{login}}-{{timestamp}}-{{your_campaign_id}}-{{your_email_id}}

login - ваш логин к SMTP
\n
timestamp - временная метка запроса
\n
your_campaign_id - ID рассылки \\ имейл-кампании
\n
your_email_id - ID конкретной отправки
\n

url это целевая ссылка
domain это track.smtprvl.ru или ваш домен

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

\n
Все значения для переменных формируются на вашей стороне.
СамОтправил не взаимодействует с контентом писем.
Если вам нужна поддержка передаваемых переменных, воспользуйтесь API
\n

\n
Ознакомьтесь подробнее с тем, какие бывают ошибки и с нашей политикой ретраев
\n

\n
Если в копии есть имейл, находящийся в стоп-листе, то отправка не будет произведена ни на один имейл
\n

\n
Обратите внимание, что если имейл находится в любом из стоп-листов, при попытке отправить письмо на этот адрес, вы будете получать ошибку 550 bounced check filter. Каждый такой запрос будет тарифицироваться системой, настройте соответствующую обработку ошибок.
В ответе также будет присутствовать поле ttl_date, в нем указана дата выхода имейла из стоп-листа. Если имейл находится в стоп-листе без возможности выхода, в ответе вы получите
\"ttl_date\": \"0\"
\n

Ошибка	Причина
550 bounced check filter	Имейл получателя находится в стоп-листе. Подробнее про работу стоп-листов
501 from domain not trusted	Домен, с которого производится отправка, не добавлен в список разрешенных
421 SMTP command timeout - closing connection	Если сделать подключение, отправить письмо, не закрыть его для дальнейшего переиспользования, и ничего не писать более 120s, то сервер запишет 421 ошибку и закроет соединение.
450 ratelimit exceeded	Превышен лимит запросов на отправку. Для новых клиентов ограничение 100 запросов в 5 минут. Напишите в поддержку, чтобы увеличить лимит

Кастомный Return-Path

Если Ваше програмное обеспечение работает с VERP форматом, создайте запрос на подключение выделенного сендера с этой фичей.

\n
Формат VERP (Variable Envelope Return Path) - это метод в электронной почте, который позволяет почтовым серверам уникально идентифицировать каждого получателя массовой рассылки, встраивая его адрес в обратный путь (envelope sender), что упрощает управление баунсами и удаление недействительных адресов без парсинга содержимого писем. Если письмо не доставляется, обратный адрес (bounce message) содержит информацию о том, кому именно оно предназначалось, позволяя автоматически отписать неработающий адрес.
\n

Пример заголовка Return-Path в VERP-формате:
Return-Path: bounce+fd1ba13a+rcptname=mail.ru@samotpravil.ru

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"26779685","collectionId":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","publishedId":"2s93RZM9in","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"22223b","highlight":"c55de0"},"publishDate":"2024-12-17T07:06:59.000Z"},"item":[{"name":"Единичная отправка","item":[{"name":"Отправка через SMTP","id":"59661a8c-11db-4aa0-b2eb-a5b8cfd80de0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"SMTP","header":[],"url":"api.samotpravil.ru:1126","description":"

\n
Логин поддерживает как числовой формат 1234, так и буквенный 1234@samotpravil.ru
\n

Telnet

telnet api.samotpravil.ru 1126 // Хост и порт\nTrying 45.136.180.204...\nConnected to spf.samotpravil.ru\nEscape character is '^]'.\n220 sender1.samotpravil.ru ESMTP ready\nhelo domain.ru // Ваш домен\n250 sender1.samotpravil.ru\nauth login // Метод авторизациии\n334 VXNlcm5hbWU6\nXXXXXXXXXXXX // Ваш логин в формате base64\n334 UGFzc3dvcmQ6\nXXXXXXXXXXXX // Ваш пароль в формате base64\n235 2.0.0 OK\nmail from:info@domain.ru // Email отправителя\n250 OK\nrcpt to:test@samotpravil.ru // Email получателя\n250 Accepted\ndata // Строим письмо\n354 Enter message, ending with \".\" on a line by itself\n// Далее идут ОБЯЗАТЕЛЬНЫЕ ЗАГОЛОВКИ\nFrom: <info@domain.ru>\nTo: <test@samotpravil.ru>\nSubject: Subject Test  // Обязательно пустая строка после темы\nHello world // Тело письма\n. // Конец тела письма\n\n

Postfix

// Создать файл /etc/postfix/sasl/sasl_passwd\nsudo nano /etc/postfix/sasl/sasl_passwd\n// Сохранить в него логин (вместо XXX) и ключ (вместо YYY):\n[api.samotpravil.ru]:1126 XXX:YYY\n// Сконвертировать текстовый файл в hash database\nsudo postmap /etc/postfix/sasl/sasl_passwd\n// Проверить права\nsudo chown root:root /etc/postfix/sasl/sasl_passwd /etc/postfix/sasl/sasl_passwd.db\nsudo chmod 0600 /etc/postfix/sasl/sasl_passwd /etc/postfix/sasl/sasl_passwd.db\n// Отредактировать настройки postfix, sudo nano /etc/postfix/main.cf\nrelayhost = [api.samotpravil.ru]:1126\nsmtp_sasl_auth_enable = yes\nsmtp_sasl_password_maps = hash:/etc/postfix/sasl/sasl_passwd\nsmtp_sasl_security_options =\n// Перезапустить postfix\nsudo service postfix restart\n\n

Exim

/ Откройте файл конфигурации Exim в текстовом редакторе. Местоположение может варьироваться в зависимости от вашей системы, но обычные пути включают /etc/exim/exim.conf или /etc/exim4/exim4.conf.\nsudo nano /etc/exim/exim.conf\n// Найдите секции routers и transports в файле конфигурации\n// Измените следующие записи:\nbegin routers\nrelay_provider:\n  driver = manualroute\n  domains = ! +local_domains\n  transport = remote_smtp\n  route_list = * api.samotpravil.ru::1126\n. . . \nbegin transports\nremote_smtp:\n  driver = smtp\n  port = 1126\n  hosts_require_tls = api.samotpravil.ru\n. . . \n//Измените следующую информацию об аутентификации в файл конфигурации, замените XXX на свой логин и YYY на пароль.:\nplain:\n  driver = plaintext\n  public_name = LOGIN\n  client_send = : XXX : YYY\n//Добавьте следующие строки для конфигурации TLS/STARTTLS:\ntls_advertise_hosts = *\n//После внесения изменений перезапустите службу Exim для применения конфигурации:\nsudo service exim restart\n//Убедитесь, что конфигурация безопасности соответствует вашим конкретным требованиям\n\n

SSMTP

// Настройте конфигурационный файл ssmtp.conf\nnano /etc/ssmtp/ssmtp.conf\nmailhub=smtp.mailganer.com:1126\n// Укажите логин (вместо XXX) и ключ (вместо YYY):\nAuthUser=XXX\nAuthPass=YYY\nUseSTARTTLS=YES\n// Дополнительные настройки\n//Домен отправителя для поля From\nrewriteDomain=example.com\n// Полное имя хоста \nhostname=hostname.example.com\n// Разрешено ли пользователям устанавливать свой собственный адрес отправителя:? \n// YES — разрешить пользователю указывать свой собственный адрес «From» \n// NO — использовать сгенерированный системой адрес «From» \nFromLineOverride=YES\n// Теперь можно отправить сообщение через команду ssmtp\n//Создайте файл nano test_message.txt\nFrom: sender@example.com\nTo: user@example.com\nSubject: Тестовое сообщение\nЭто тестовое сообщение. \n// Затем используйте следующую команду, чтобы отправить это сообщение:\nssmtp user@example.com < test_message.txt\n\n

Python

import time\nimport smtplib\nfrom email.message import EmailMessage\nfrom email.utils import formataddr\nclass EmailSender:\n    def __init__(\n            self, login: str, password: str,\n            smtp_host: str = 'api.samotpravil.ru', smtp_port: int = 1126\n        ) -> None:\n        self.login = login\n        self.password = password\n        self.smtp_host = smtp_host\n        self.smtp_port = smtp_port\n    @staticmethod\n    def generate_x_track_id(login: str) -> str:\n        return f'{login}_{int(time.time())}'\n    @staticmethod\n    def load_email_content(\n            content_path: str, x_track_id: str, content_html: bool\n        ) -> str:\n        if content_html:\n            with open(content_path, 'r', encoding='utf-8') as html:\n                return html.read().replace('{{X-Track-ID}}', x_track_id)\n        return content_path\n    @staticmethod\n    def create_email(\n            sender_name: str, sender_email: str, to_emails: list[str], cc_emails: list[str],\n            subject: str, body: str, x_track_id: str\n        ) -> EmailMessage:\n        email = EmailMessage()\n        email['Subject'] = subject\n        email['From'] = formataddr((sender_name, sender_email))\n        email['To'] = ', '.join(to_emails)\n        if cc_emails:\n            email['Cc'] = ', '.join(cc_emails)\n        email['X-Track-ID'] = x_track_id\n        email.set_content(body, subtype='html')\n        return email\n    @staticmethod\n    def add_attachment(email, attachment_path):\n        with open(attachment_path, 'rb') as content_file:\n            content = content_file.read()\n            maintype, subtype = attachment_path.split('.')[-2:]\n            email.add_attachment(content, maintype='application', subtype=subtype, filename=attachment_path)\n    def send_email(\n            self, sender_name: str, sender_email: str, to_emails: list[str], subject: str, email_content: str,\n            content_html: bool = True, attachment_path: str = None,\n            cc_emails: list[str] = None, bcc_emails: list[str] = None\n        ) -> None:\n        x_track_id = self.generate_x_track_id(self.login)\n        recipients = [email.split(';')[0] for email in to_emails]\n        body = self.load_email_content(email_content, x_track_id, content_html)\n        email = self.create_email(sender_name, sender_email, recipients, cc_emails, subject, body, x_track_id)\n        if attachment_path:\n            self.add_attachment(email, attachment_path)\n        all_recipients = recipients + (cc_emails if cc_emails else []) + (bcc_emails if bcc_emails else [])\n        try:\n            with smtplib.SMTP(self.smtp_host, self.smtp_port) as smtp:\n                smtp.set_debuglevel(1)  # Вывод лога SMTP диалога\n                smtp.starttls()\n                smtp.login(self.login, self.password)\n                smtp.send_message(email, sender_email, all_recipients)\n            print(\"Email sent successfully!\")\n        except Exception as ex:\n            print(\"Something went wrong...\", ex)\nif __name__ == '__main__':\n    email_sender = EmailSender(login='1234', password='pass')\n    email_sender.send_email(\n        sender_name='mailganer.com',\n        sender_email='info@mailguner.com',\n        to_emails=['example1@mailganer.com'],\n        cc_emails=['example2@mailganer.com'],\n        bcc_emails=['example3@mailganer.com'],\n        subject='Тема письма',\n        email_content='Контент письма',\n        content_html=False,\n        attachment_path='Путь до файла с вложением'\n    )\n\n

\n","urlObject":{"port":"1126","host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[],"_postman_id":"59661a8c-11db-4aa0-b2eb-a5b8cfd80de0"},{"name":"Отправка через API","id":"d38df6bc-71da-4445-a1eb-bbc299138836","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет, {{ name }}!\", // Тема письма\n \"message_text\": \"

Привет,{% if name %} {{ name }}{% else %} друг{% endif %}! В этот день теплом вашим я согрет {{ other }}. Мне сегодня {% if age == '30' %} 30{% else %} не 30{% endif %} лет link

А тут можно использовать сырую переменную {% raw %}{{name}}{% endraw %}

Ссылка отписки

В этом методе можно использовать синтаксис Jinja2. Такие констуркции, как:

{% if %}{% endif %}
\n
{% for %}{% endfor %}
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Название	Переменная	Тип	Обязательный	Комментарий
Отправитель	email_from	Строка	✔	Формат: ИмяОтправителя <ИмейлОтправителя>
Получатель	email_to	Строка	✔
Тема письма	subject	Строка	✔
Вёрстка письма	message_text	Строка	✔ если не передан template_id
ID шаблона в Mailganer	template_id		✔ если не передан message_text	Для работы необходимо передать заголовок `Mg-Api-Key` с API-ключом от Mailganer
Свои переменные	params	json-массив	✔	Передайте пары переменная-значение. Значения должны быть string
Проверка по глобальному стоп-листу	check_stop_list	Булев		Подробнее про проверку по стоп-листам
Проверка по локальному (клиентскому) стоп-листу	check_local_stop_list	Булев		Выключает проверку по локальному стоп-листу. По дефолту true. Для подключения данной фичи обратитесь в службу поддержки
X-Track-ID	x_track_id	Строка		Пользовательский ID. Должен быть уникальным для каждой отправки. Хорошая практика формирования X-Track-ID - `{{login}}-{{timestamp}}-{{your-id}}` login - ваш логин к SMTP, timestamp - временная метка запроса, your-id - любой понятный вам ID
Домен для DKIM	domain_for_dkim	Строка		Домен, которым подписать письмо. Если не указан, то домен берётся из email_from
Отслеживать открытия	track_open	Булев		Для работы необходимо передавать параметр x_track_id
Отслеживать клики	track_click	Булев		Для работы необходимо передавать параметр x_track_id
Домен трекинга	track_domain	Строка		Можно настроить свой домен трекинга
Свои заголовки	headers	json-массив		Передайте пары заголовок-значение
Ссылка отписки	params.sys_unsubscribe_url	Строка		Зарезервированная переменная

Для настройки своего домена для треккинга, создайте обращение на support@samotpravil.ru

А тут можно использовать сырую переменную {% raw %}{{name}}{% endraw %}

Ссылка отписки

А тут можно использовать сырую переменную {% raw %}{{name}}{% endraw %}

Ссылка отписки

\", // Тело письма HTML\n \"template_id\": 26338, // ID шаблона в Mailganer\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным стоп-листам\n \"track_open\": true, // Отслеживать открытия. Для работы необходимо передавать параметр x_track_id\n \"track_click\": true, // Отслеживать переходы. Для работы необходимо передавать параметр x_track_id\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"name\": \"Вася\",\n \"other\": \"шмель\",\n \"age\": \"30\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v1/smtp_send"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:29:27 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"86eeb3d0-d0df-412b-8e91-22039c18dcf1","name":"Не передано необходимое поле","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \",\n \"email_to\": \"samotpravil@mail.ru\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v1/smtp_send"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:24:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"255"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request send mail data: Key: 'mailSendForm.Subject' Error:Field validation for 'Subject' failed on the 'required' tag\\nKey: 'mailSendForm.MessageText' Error:Field validation for 'MessageText' failed on the 'required' tag\"\n}"},{"id":"6efeb4b3-ebfe-4550-b06c-3e3cee43e8ba","name":"Email получателя в стоп-листе","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет, {{ name }}!\", // Тема письма\n \"message_text\": \"

А тут можно использовать сырую переменную {% raw %}{{name}}{% endraw %}

Ссылка отписки

\", // Тело письма HTML\n \"template_id\": 26338, // ID шаблона в Mailganer\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным стоп-листам\n \"track_open\": true, // Отслеживать открытия. Для работы необходимо передавать параметр x_track_id\n \"track_click\": true, // Отслеживать переходы. Для работы необходимо передавать параметр x_track_id\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"name\": \"Вася\",\n \"other\": \"шмель\",\n \"age\": \"30\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v1/smtp_send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"error send mail: 550 bounced check filter\", // Подробнее о работе стоп-листов в статье: https://mailganer.com/ru/explanation/stop-listy-smtp\n \"code\": 550,\n \"ttl_date\": \"2025-12-04\" // Дата выхода имейла из стоп-листа\n}"},{"id":"35cc0d77-c0df-4397-8136-b182cc3625a9","name":"Попытка отправить с неавторизованного домена","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет, {{ name }}!\", // Тема письма\n \"message_text\": \"

А тут можно использовать сырую переменную {% raw %}{{name}}{% endraw %}

Ссылка отписки

\", // Тело письма HTML\n \"template_id\": 26338, // ID шаблона в Mailganer\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным стоп-листам\n \"track_open\": true, // Отслеживать открытия. Для работы необходимо передавать параметр x_track_id\n \"track_click\": true, // Отслеживать переходы. Для работы необходимо передавать параметр x_track_id\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"name\": \"Вася\",\n \"other\": \"шмель\",\n \"age\": \"30\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v1/smtp_send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"error send mail: smtp error, cmd: close: 501 from domain not trusted\",\n \"code\": 501\n}"},{"id":"d25a7508-d8ac-4bdc-b3fa-82c378a0b9ef","name":"Невалидный имейл","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil+-111Ё@mail.ru\", // Имейл получателя\n \"subject\": \"Привет, {{ name }}!\", // Тема письма\n \"template_id\": 26338 // ID шаблона в Mailganer\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v1/smtp_send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"error send mail: smtp error, cmd: rcpt to: 553 bad email\",\n \"code\": 553\n}"}],"_postman_id":"d38df6bc-71da-4445-a1eb-bbc299138836"}],"id":"ccf1877e-736b-4c02-9e03-ad79ffaf0e8c","description":"

Отправить письмо можно по SMTP или HTTP протоколу. В одном обращении к API одна отправка.

\n
Обратите внимание, что сервис не логирует тело письма в единичном методе отправок
\n

\n
Среднее время ответа сервиса в единичных методах отправок - 500 мс.
Рекомендуемый таймаут - 30 сек.
Рекомендуемый промежуток перед повторной попыткой - 60 сек.
\n

\n","_postman_id":"ccf1877e-736b-4c02-9e03-ad79ffaf0e8c","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Пакетная отправка","item":[{"name":"Отправка XML v1","id":"9dbf38c0-8438-465a-bac6-66508500f419","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v1/add_package?url=https://example.com/xml_package.xml","description":"

Возможные значения поля статус

Пример XML-пакета

<list>\n  <body>\n    <Data>\n            <![CDATA[ <html>\n            <img class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; src=\"cid:de43239e9118fe7c44d915072f99cd15\"/> // пример как встроить файл вёрстку\n            Код: {{field1}} // пример подстановки переменной\n            {% if name %} // пример оператора условия if\n               Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n            {% else %}\n               Здравствуйте!\n            {% endif %}\n            {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n               Код больше 100\n            {% endif %}\n            {% for pr in products %} // пример оператора цикла for\n               <a class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; href=\"{{ pr.link }}\">{{ pr.name }}</a>\n               <strong class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>{{ pr.price }}</b>\n            {% endfor %}\n            {{single_el_field.name}} // как обратиться атрибуту поля из одного элемента\n        </html>\n    ]]>\n    </Data> // Обычная вёрстка письма\n    <Data-amp>...</Data-amp> // AMP-вёрстка письма, необязательное поле\n    <NameFrom>Company</NameFrom> // Имя отправителя\n    <EmailFrom>test@domain.ru</EmailFrom> // Имейл отправителя\n    <Subject>mail subject</Subject> // Тема письма\n    <wrap_redirect_link>1</wrap_redirect_link> // Включает отслеживание кликов в рассылке\n    <domain_redirect_link>track.samotpravil.ru</domain_redirect_link> // Домен для отслеживания кликов\n    <Header name=\"foo1\" value=\"bar1\" />\n    <Header name=\"foo2\" value=\"bar2\" /> // Собственные заголовки письма\n    <Header name=\"Precedence\" value=\"transaction\" /> // Отключает проверку по клиентскому стоп-листу. Запросите активацию в службе поддержки\n    <check_global_stop_list>0</check_global_stop_list> // Отключает проверку по глобальному стоп-листу\n    <attach name=\"image.jpg\" mimetype=\"image/jpeg\" cid=\"de43239e9118fe7c44d915072f99cd15\">...</attach> // Пример вложения в письмо\n    <html_prettify>1</html_prettify> // форматирует html\n    <external_id>segseg2412--23489</external_id> // ваш ID пакета\n  </body>\n  <users>\n    <user>\n      <EmailTo>email@domain.com</EmailTo> // Имейл получателя\n      <field_string>Строковая переменная</field_string>\n      <field_bool type=\"bool\">true</field_bool>\n      <field_int type=\"int\">1</field_int>\n      <field_float type=\"float\">1.2</field_float>\n      <name>Даниил</name>\n      <products force_array=\"true\" link=\"baz1\" name=\"foo1\" price=\"bar1\" />\n      <products force_array=\"true\" link=\"baz2\" name=\"foo2\" price=\"bar2\" />\n      <single_el_field name=\"foo1\" />\n      …\n      <fieldN></fieldN>\n    </user>\n    …\n  </users>\n</list>\n\n

Название	Переменная	Тип	Обязательный	Комментарий
Имейл отправителя	email_from	Строка	✔
Имя отправителя	name_from	Строка	✔
Тема письма	subject	Строка	✔
Вёрстка письма	message_text	Строка	✔
AMP вёрстка письма	message_text_amp	Строка
Проверка по локальному (клиентскому) стоп-листу	check_local_stop_list	Булев		Выключает проверку по локальному стоп-листу. По дефолту true. Для подключения данной фичи обратитесь в службу поддержки
Проверка по глобальному стоп-листу	check_global_stop_list	Булев
Отслеживать открытия	track_open	Булев		Для работы необходимо передавать параметр x_track_id
Отслеживать клики	track_click	Булев		Для работы необходимо передавать параметр x_track_id
Домен трекинга	track_domain	Строка		Можно настроить свой домен трекинга
Свои заголовки	headers	json-массив		Передайте пары заголовок-значение
Включить модерацию	is_moderate	Булев		Включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для WhiteLabel клиентов
Форматировать html	html_prettify	Булев		Красиво форматирует верстку с отступами
Внешний ID пакета	external_id	Строка		Клиентский ID пакета. Приходит в вебхуках
Получатели	users	Массив[]	✔	Массив объектов получателей

Для настройки своего домена для треккинга, пропишите CNAME запись на track.samotpravil.ru. Затем создайте обращение на support@samotpravil.ru, чтобы мы добавили ваш домен в разрешенные

Структура объекта users[]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Название	Переменная	Тип	Обязательный	Комментарий
Email получателя	emailto	Строка	✔
Имя получателя	name	Строка		Любая строка, можно использовать в шаблоне письма.
Дополнительное поле	field1	Строка		Любая дополнительная переменная.
Вложенный массив	nested_array	Массив объектов
Массив строк	string_array	Массив объектов

Структура объекта nested_array[]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Название	Переменная	Тип	Обязательный	Комментарий
Любая своя переменная	field_name	Строка	✔

Структура объекта string_array[]

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Название	Переменная	Тип	Обязательный	Комментарий
Значение	name	Строка	✔	Элемент массива строк.

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": {\n \"status\": \"S005\",\n \"pack_id\": 123456\n }\n}"},{"id":"9f17bccf-1e19-4787-ad52-4a6f6d024a17","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"unauthorized\"\n}"},{"id":"e0a25e71-190b-4e6a-aa09-bb4638f8b330","name":"Некорректный контент","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"content-type application/json required\"\n}"},{"id":"89c75a84-cdda-44b3-b426-89365b32d957","name":"Ошибка декода пакета","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"\"\n}"},{"id":"63dd7bcc-1429-4e8e-af8c-9721949dcb22","name":"Пустой пакет","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"JSON package is empty: null\" // JSON package is empty: {} || JSON package is empty: []\n}"},{"id":"d6c2e4e9-3751-483c-a27a-c336d0bbeeb0","name":"Отсутствует необходимое поле","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Json format error: json package field required: message_text\" // message_text - название поля\n}"},{"id":"8cc36a3e-3a57-43c3-a97f-83a02f3da205","name":"Имейл получателя не найден","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Json format error: json package: emailto field not found in user\"\n}"},{"id":"1faa4282-80f0-43e8-9bff-1b75c0973962","name":"Внутренняя ошибка","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"info@domain.ru\", // имейл отправителя\n \"name_from\": \"Domain\", // имя отправителя\n \"subject\": \"Привет {{ name }}\", // тема письма\n \"check_local_stop_list\": false, // управление локальным стоп-листом (включается по запросу)\n \"check_global_stop_list\": true, // управление глобальным стоп-листом\n \"is_moderate\": false, // включает необходимость промодерировать рассылку со стороны SamOtpravil. Флаг актуален для whitelabel клиентов\n \"message_text\": \n \"\n

// пример как встроить файл вёрстку\n\n Код: {{field1}} // пример подстановки переменной\n\n {% if name %} // пример оператора условия if\n Здравствуйте, {{name}}! // поддерживается синтаксис jinja\n {% else %}\n Здравствуйте!\n {% endif %}\n\n {% if field1|int > 100 %} // чтобы работали условия для цифр, нужно добавлять |int\n Код больше 100\n {% endif %}\n\n {% for pr in products %} // пример оператора цикла for\n {{ pr.name }}\n {{ pr.price }}\n {% endfor %}\n Отписаться\n \", // верстка письма\n \"message_text_amp\": \"Контент для AMP\",\n \"headers\": {\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n }, // заголовки\n \"track_open\": true, // отслеживать открытия\n \"track_click\": true, // отслеживать клики\n \"track_domain\": \"track.samotpravil.ru\", // домен для редиректов\n \"external_id\": \"segseg2412--23489\", // ваш ID пакета\n \"users\": [\n { \n \"emailto\": \"to1@domain.com\", // Имейл получателя\n \"name\": \"Вася\", // любые переменные\n \"field_bool\": true,\n \"field_int\": 400,\n \"field_float\": 40.0,\n \"products\": [\n {\n \"name\":\"foo1\",\n \"price\":\"bar1\",\n \"link\":\"baz1\"\n },\n {\n \"name\":\"foo2\",\n \"price\":\"bar2\",\n \"link\":\"baz2\"\n }\n ] // пример вложенного массива\n },\n {\n \"emailto\": \"to2@domain.com\",\n \"string_array\": [\n {\"name\": \"foo1\"},\n {\"name\": \"foo2\"}\n ] // пример массива строк\n },\n {\n ...\n } \n ] // массив с получателями\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.samotpravil.ru/api/v1/add_json_package?key=XXX","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","add_json_package"],"query":[{"key":"key","value":"XXX"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"internal error\" // internal error, convert package || internal error, package not accepted || internal error: Empty xml service response || internal error: ('Error parse pack_id', ) || internal error: Error parse xml service response\n}"}],"_postman_id":"91fa5d31-0228-48ed-81b1-f578a21d325b"},{"name":"Остановить отправку","id":"520e251f-5a15-4f60-94e0-f5e088100209","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v1/package_stop?pack_id=66677","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v1","package_stop"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

ID пакета, который нужно остановить

\n","type":"text/plain"},"key":"pack_id","value":"66677"}],"variable":[]}},"response":[{"id":"203fe7f4-f024-4517-811d-10b84629c146","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v1/package_stop?key=XXX&pack_id=66677","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","package_stop"],"query":[{"key":"key","value":"XXX"},{"key":"pack_id","value":"66677","description":"ID пакета, который нужно остановить"}]}},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 11:08:02 GMT"},{"key":"Content-Type","name":"Content-Type","value":"application/xml","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"\n\n XXXX\n"}],"_postman_id":"520e251f-5a15-4f60-94e0-f5e088100209"},{"name":"Статус пакета","id":"075a17c2-e0e7-4b36-9e77-b046667e982f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/package/status?issuen=123456","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Код	Описание
E000	Неверный API ключ
E001	Не передан URL
E002	Не передан pack_id
E003	Информация о пакете не найдена
S004	Пакет отправляется
S005	Пакет принят
S007	В процессе обработки возникла ошибка
S009	В очереди на генерацию
S011	Пакет обрабатывается
S013	Рассылка отменена пользователем
S018	Пакет отправлен
S020	Пакет на модерации
S021	Прошёл модерацию
S022	Не прошёл модерацию

Визуализация смены статусов пакетов

","urlObject":{"protocol":"https","path":["api","v2","package","status"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

Числовой ID пакета

\n","type":"text/plain"},"key":"issuen","value":"123456"}],"variable":[]}},"response":[{"id":"f4dc5086-790a-4937-864c-6624b7e1f73e","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/package/status?issuen=123456","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","package","status"],"query":[{"key":"issuen","value":"123456"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 11:32:11 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"items\": [\n {\n \"issuen\": 123456,\n \"status_code\": \"S018\",\n \"status_text\": \"Пакет отправлен. Информация о пакете удалена.\"\n }\n ]\n}"},{"id":"7d2ce395-0bb8-47aa-9d2b-e8febfd75c54","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/package/status?issuen=123456","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","package","status"],"query":[{"key":"issuen","value":"123456"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 11:32:11 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"0974e8c3-b28f-4112-bc8f-9f733fcd1de1","name":"Невалидные параметры","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/package/status?issuen=ABCDEF","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","package","status"],"query":[{"key":"issuen","value":"ABCDEF"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 11:32:11 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"075a17c2-e0e7-4b36-9e77-b046667e982f"}],"id":"f03efa2b-f34c-4035-ab52-a224984bc8f5","description":"

Массовая отправка на группу имейлов до 200000 получателей

\n","_postman_id":"f03efa2b-f34c-4035-ab52-a224984bc8f5","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Отчеты","item":[{"name":"Статус доставки","id":"0cee65d5-4fe3-4efb-916a-23759269bfc7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/status?x_track_id=299_20230621_135411","description":"

Возвращает последний статус доставки по message_id или x_track_id.

Возможные возвращаемые статусы:

accepted
\n
delivered
\n
failed
\n
fbl
\n
unsubscribe
\n

Данный метод заточен под быструю скорость отдачи и НЕ возвращает статусы

open
\n
click
\n

Таблица с описанием статусов https://documentation.samotpravil.ru/view/26779685/2s93RZM9in#9381971e-6b2d-4476-8614-8f1e68306b6c

Обратите внимание, что поле created_at возвращает timestamp в UTC+3

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","issue","status"],"host":["api.samotpravil.ru"],"query":[{"disabled":true,"key":"message_id","value":"1qBv3w-0007Ls-CS11"},{"disabled":true,"key":"message_id","value":"1lWv34-0003Fe-Lb"},{"key":"x_track_id","value":"299_20230621_135411"}],"variable":[]}},"response":[{"id":"9ad01aa7-e84a-4d85-9093-dc3557d08dc4","name":"Успешный запрос по Message ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/status?message_id=1qBv3w-0007Ls-CS","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"12345678\",\n \"status\": \"failed\",\n \"reason\": \"H=mx02.mail.icloud.com [17.56.9.29] CV=yes: 550 5.1.1 : user does not exist\",\n \"created_at\": 1697746906\n },\n {\n \"message_id\": \"1ttZWY-0004YZ-88\",\n \"x_track_id\": \"11308544\",\n \"status\": \"failed\",\n \"created_at\": 1697746906\n },\n {\n \"message_id\": \"123\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"63b10279-3d47-43f3-add7-cfaa4e02da10","name":"Успешный запрос по X-Track-ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/status?x_track_id=299_20230621_1354","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11","disabled":true},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true},{"key":"x_track_id","value":"299_20230621_1354"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:54:57 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"140"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"15308543\",\n \"status\": \"failed\",\n \"reason\": \"H=mx02.mail.icloud.com [17.56.9.29] CV=yes: 550 5.1.1 : user does not exist\",\n \"created_at\": 1697746906\n },\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"11308544\",\n \"status\": \"failed\",\n \"created_at\": 1697746906\n },\n {\n \"x_track_id\": \"12345678\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"e065a86a-9741-4e98-99f4-654667ed2fe4","name":"Message ID не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/status?message_id=1qBv3w-0007Ls-CS11","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:50:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"85"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qBv3w-0007Ls-CS11\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"f7b17450-a62f-488a-9c06-a3c70f9d6d0a","name":"X-Track-ID не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/status?x_track_id=299_20230621_135411","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11","disabled":true},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true},{"key":"x_track_id","value":"299_20230621_135411"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:57:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"86"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"x_track_id\": \"299_20230621_135411\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"3edc4481-b492-4fb0-96d6-153579ba04e6","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/status?message_id=1qBv3w-0007Ls-CS","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"ef1d8d20-2332-4b4a-92b6-55215da5de67","name":"Невалидные параметры","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/status"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"0cee65d5-4fe3-4efb-916a-23759269bfc7"},{"name":"Все статусы","id":"cbc5af90-35a5-4067-aee3-48bf873cd7c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/ext_status?x_track_id=299_20230621_135411","description":"

Возвращает ВСЮ историю статусов доставки по message_id или x_track_id.

Таблица с описанием статусов https://documentation.samotpravil.ru/view/26779685/2s93RZM9in#9381971e-6b2d-4476-8614-8f1e68306b6c

Обратите внимание, что поле created_at возвращает timestamp в UTC+3

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","issue","ext_status"],"host":["api.samotpravil.ru"],"query":[{"disabled":true,"key":"message_id","value":"1qBv3w-0007Ls-CS11"},{"disabled":true,"key":"message_id","value":"1lWv34-0003Fe-Lb"},{"key":"x_track_id","value":"299_20230621_135411"}],"variable":[]}},"response":[{"id":"fc02e0ee-d011-4d12-a13c-eb8e02c20906","name":"Успешный запрос по Message ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/ext_status?message_id=1qBv3w-0007Ls-CS","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","ext_status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"107"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"12345678\",\n \"status\": \"accpted\",\n \"created_at\": 1697746903\n },\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"12345678\",\n \"status\": \"failed\",\n \"reason\": \"H=mx02.mail.icloud.com [17.56.9.29] CV=yes: 550 5.1.1 : user does not exist\",\n \"created_at\": 1697746906\n }\n ]\n}"},{"id":"c35f4fd3-1dc4-4fd0-932b-161c3addc3ef","name":"Успешный запрос по X-Track-ID","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/ext_status?x_track_id=299_20230621_1354","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","ext_status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11","disabled":true},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true},{"key":"x_track_id","value":"299_20230621_1354"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:54:57 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"140"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"299_20230621_1354\",\n \"status\": \"accpted\",\n \"created_at\": 1697746903\n },\n {\n \"message_id\": \"1qtZWY-0004YZ-8M\",\n \"x_track_id\": \"299_20230621_1354\",\n \"status\": \"failed\",\n \"reason\": \"H=mx02.mail.icloud.com [17.56.9.29] CV=yes: 550 5.1.1 : user does not exist\",\n \"created_at\": 1697746906\n }\n ]\n}"},{"id":"c30bc3d0-851a-481a-9c64-27098b81f403","name":"Message ID не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/ext_status?message_id=1qBv3w-0007Ls-CS11","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","ext_status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:50:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"85"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"message_id\": \"1qBv3w-0007Ls-CS11\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"7752f52f-5e07-44a9-8fc9-36c7f5af40d7","name":"X-Track-ID не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/ext_status?x_track_id=299_20230621_135411","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","ext_status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS11","disabled":true},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true},{"key":"x_track_id","value":"299_20230621_135411"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:57:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"86"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"messages\": [\n {\n \"x_track_id\": \"299_20230621_135411\",\n \"status\": \"not_found\"\n }\n ]\n}"},{"id":"2846a124-231a-463a-843a-5f9ad6366218","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/ext_status?message_id=1qBv3w-0007Ls-CS","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","ext_status"],"query":[{"key":"message_id","value":"1qBv3w-0007Ls-CS"},{"key":"message_id","value":"1lWv34-0003Fe-Lb","disabled":true}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"0ab8463a-2500-4740-82ed-6b91f591a824","name":"Невалидные параметры","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/ext_status"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:48:24 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"cbc5af90-35a5-4067-aee3-48bf873cd7c8"},{"name":"Недоставки за период","id":"f7a7690a-ad7c-4cc0-ac03-301200259199","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/report/non-delivery?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345&order=asc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","blist","report","non-delivery"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

Дата начала

\n","type":"text/plain"},"key":"date_from","value":"2024-02-20"},{"description":{"content":"

Дата конца

\n","type":"text/plain"},"key":"date_to","value":"2024-02-20"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

Необязательный параметр. По умолчанию значение asc.\nВозможные варианты:\nasc - в порядке возрастания,\ndesc - в порядке убывания.

\n","type":"text/plain"},"key":"order","value":"asc"}],"variable":[]}},"response":[{"id":"7ff0982d-07e5-40eb-ba00-a06eb02f4576","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/non-delivery?date_from=2024-02-20&date_to=2024-02-20&limit=5","protocol":"https","host":["api","samotpravil","ru"],"path":["api","v2","blist","report","non-delivery"],"query":[{"key":"date_from","value":"2024-02-20"},{"key":"date_to","value":"2024-02-20"},{"key":"limit","value":"5"},{"key":"cursor_next","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 16476640\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:05:02\",\n \"email\": \"email@icloud.com\",\n \"code\": 550,\n \"message\": \"SMTP error from remote mail server after end of data: 554 5.7.1 [HM07] Message rejected due to local policy. Please visit https://support.apple.com/en-us/HT204137\",\n \"x_track_id\": \"foo\"\n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@example.com\",\n \"code\": 550,\n \"message\": \": 550 5.4.1 Recipient address rejected: Access denied. [AM2PEPF0001C70F.eurprd05.prod.outlook.com 2024-04-30T21:05:27.141Z 08DC671B10BE7E81]\",\n \"x_track_id\": \"foo\"\n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@yandex.ru\",\n \"code\": 550,\n \"message\": \": 550 5.7.1 No such user! 1714511117-G5ZenAPdPW20-ibDRfL5K\",\n \"x_track_id\": \"foo\"\n }\n ]\n}"},{"id":"8fd99ed9-47a0-428f-b781-84b04abba1b5","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/non-delivery?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","non-delivery"],"query":[{"key":"date_from","value":"2024-02-20","description":"Дата начала"},{"key":"date_to","value":"2024-02-20","description":"Дата конца"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"0e3e229f-e444-4b4d-b3fd-38e6efcb61fd","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/non-delivery?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","non-delivery"],"query":[{"key":"date_from","value":"2024-02-20","description":"Дата начала"},{"key":"date_to","value":"2024-02-20","description":"Дата конца"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"f7a7690a-ad7c-4cc0-ac03-301200259199"},{"name":"Недоставки по выпуску","id":"01de9691-fe9d-47aa-b00b-35c97091ea5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/report/non-delivery?issuen=123456&issuen=678901&limit=5&cursor_next=12345&order=asc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","issue","report","non-delivery"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"123456"},{"description":{"content":"

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"678901"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

\n","type":"text/plain"},"key":"order","value":"asc"}],"variable":[]}},"response":[{"id":"0fed09d6-5726-4606-aba6-98069588f0e0","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/report/non-delivery?issuen=123456&limit=5","protocol":"https","host":["api","samotpravil","ru"],"path":["api","v2","issue","report","non-delivery"],"query":[{"key":"issuen","value":"123456"},{"key":"limit","value":"5"},{"key":"cursor_next","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": { // Необязательный. Объект пагинации\n \"cursor_next\": 123456 // Значение для параметра cursor_next для перехода на следующую страницу\n },\n \"status\": \"ok\",\n \"report\": [ // Массив в жалобами\n {\n \"issuen\": 123456, // ID выпуска\n \"email\": \"fbl_email1@inbox.ru\", // Имейл пожаловавшегося\n \"domain\": \"domain.com\", // Домен, на который пришла жалоба\n \"date\": \"2024-02-20 15:09:49\", // Дата получения жалобы\n \"x_track_id\": \"foo\" // Ваш x_track_id\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email2@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:50\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email3@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:51\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email4@bk.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:52\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email5@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:53\",\n \"x_track_id\": \"\"\n }\n ]\n}"},{"id":"4e7870a1-179e-4915-9952-a44295a14cc5","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/report/non-delivery?issuen=123456&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","report","non-delivery"],"query":[{"key":"issuen","value":"123456","description":"ID выпуска"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"08207de9-2cff-44a9-a392-3b0d41f7896b","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/report/non-delivery?issuen=123456&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","report","non-delivery"],"query":[{"key":"issuen","value":"123456","description":"ID выпуска"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"01de9691-fe9d-47aa-b00b-35c97091ea5a"},{"name":"Жалобы за период","id":"49ddff28-6b93-48fa-a7fc-0fbd63a73791","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/report/fbl?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345","description":"

\n
Если имейл из копии (CC) или скрытой копии (BCC) пожаловался на письмо, то в отчете будет указан только имейл из заголовка TO
\n

Дата начала

\n","type":"text/plain"},"key":"date_from","value":"2024-02-20"},{"description":{"content":"

Дата конца

\n","type":"text/plain"},"key":"date_to","value":"2024-02-20"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"}],"variable":[]}},"response":[{"id":"4c948813-0c6b-4a5a-8d10-8aa6366a2d5c","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?date_from=2024-02-20&date_to=2024-02-20&limit=5","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"date_from","value":"2024-02-20"},{"key":"date_to","value":"2024-02-20"},{"key":"limit","value":"5"},{"key":"cursor_next","value":null,"type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": { // Необязательный. Объект пагинации\n \"cursor_next\": 123456 // Значение для параметра cursor_next для перехода на следующую страницу\n },\n \"status\": \"ok\",\n \"report\": [ // Массив в жалобами\n {\n \"issuen\": 123456, // ID пакета\n \"email\": \"fbl_email1@inbox.ru\", // Имейл пожаловавшегося\n \"domain\": \"domain.com\", // Домен, на который пришла жалоба\n \"date\": \"2024-02-20 15:09:49\", // Дата получения жалобы\n \"x_track_id\": \"foo\" // Ваш x_track_id\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email2@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:50\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email3@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:51\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email4@bk.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:52\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email5@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:53\",\n \"x_track_id\": \"\"\n }\n ]\n}"},{"id":"745ff3a8-e3b7-40bc-ad9e-66fe44252b2e","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"date_from","value":"2024-02-20","description":"Дата начала"},{"key":"date_to","value":"2024-02-20","description":"Дата конца"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"5ca0402c-145c-495e-8190-218cee86cc95","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"date_from","value":"2024-02-20","description":"Дата начала"},{"key":"date_to","value":"2024-02-20","description":"Дата конца"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"49ddff28-6b93-48fa-a7fc-0fbd63a73791"},{"name":"Жалобы на выпуск","id":"9b28ba17-7fd4-4e80-b647-c9baf9d2d979","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/report/fbl?issuen=123456&issuen=678901&limit=5&cursor_next=12345","description":"

\n
Если имейл из копии (CC) или скрытой копии (BCC) пожаловался на письмо, то в отчете будет указан только имейл из заголовка TO
\n

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"123456"},{"description":{"content":"

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"678901"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"}],"variable":[]}},"response":[{"id":"aa6c1ecd-a953-4a27-850f-f9e8d212b6b8","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?issuen=123456&limit=5","protocol":"https","host":["api","samotpravil","ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"issuen","value":"123456"},{"key":"limit","value":"5"},{"key":"cursor_next","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": { // Необязательный. Объект пагинации\n \"cursor_next\": 123456 // Значение для параметра cursor_next для перехода на следующую страницу\n },\n \"status\": \"ok\",\n \"report\": [ // Массив в жалобами\n {\n \"issuen\": 123456, // ID выпуска\n \"email\": \"fbl_email1@inbox.ru\", // Имейл пожаловавшегося\n \"domain\": \"domain.com\", // Домен, на который пришла жалоба\n \"date\": \"2024-02-20 15:09:49\", // Дата получения жалобы\n \"x_track_id\": \"foo\" // Ваш x_track_id\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email2@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:50\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email3@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:51\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email4@bk.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:52\",\n \"x_track_id\": \"\"\n },\n {\n \"issuen\": 123456,\n \"email\": \"fbl_email5@mail.ru\",\n \"domain\": \"domain.com\",\n \"date\": \"2024-02-20 15:09:53\",\n \"x_track_id\": \"\"\n }\n ]\n}"},{"id":"8c29294a-cca8-4517-9c0f-404b271c4227","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?issuen=123456&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"issuen","value":"123456","description":"ID выпуска"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"3e437bf0-7b3c-485e-a1c6-0f29d0f3b6b9","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/fbl?issuen=123456&limit=5&cursor_next=12345","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","fbl"],"query":[{"key":"issuen","value":"123456","description":"ID выпуска"},{"key":"limit","value":"5","description":"Необязательный параметр. Лимит объектов в массиве. Стандартно 100"},{"key":"cursor_next","value":"12345","description":"Необязательный параметр. Пагинация"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"9b28ba17-7fd4-4e80-b647-c9baf9d2d979"},{"name":"Отписки за период","id":"83d71d3e-165b-44fd-839c-b8309aa8d0ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/report/unsubscribe?date_from=2024-02-20&date_to=2024-02-20&limit=5&cursor_next=12345&order=asc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","blist","report","unsubscribe"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

Дата начала

\n","type":"text/plain"},"key":"date_from","value":"2024-02-20"},{"description":{"content":"

Дата конца

\n","type":"text/plain"},"key":"date_to","value":"2024-02-20"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

\n","type":"text/plain"},"key":"order","value":"asc"}],"variable":[]}},"response":[{"id":"7b5baf5a-69fd-43b0-a210-61e8ea58378d","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist/report/unsubscribe","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist","report","unsubscribe"],"query":[{"key":"cursor_next","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 16476640\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:05:02\",\n \"email\": \"email@icloud.com\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@example.com\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@yandex.ru\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n }\n ]\n}"},{"id":"1482670d-3126-4edd-a123-596c301e810e","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/report/unsubscribe"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"1004463c-677f-4bdb-8a51-40539721a8b5","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/report/unsubscribe"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"83d71d3e-165b-44fd-839c-b8309aa8d0ea"},{"name":"Отписки по выпуску","id":"c13b5e7f-80c1-4c36-be73-c81779dbae1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/report/unsubscribe?issuen=123456&issuen=678901&limit=5&cursor_next=12345&order=asc","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","issue","report","unsubscribe"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"123456"},{"description":{"content":"

ID выпуска

\n","type":"text/plain"},"key":"issuen","value":"678901"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

\n","type":"text/plain"},"key":"order","value":"asc"}],"variable":[]}},"response":[{"id":"66e3268f-c400-4e18-8e97-e05e612ca88c","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/report/unsubscribe","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","report","unsubscribe"],"query":[{"key":"cursor_next","value":null,"disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 14:45:10 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"652"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 16476640\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:05:02\",\n \"email\": \"email@icloud.com\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@example.com\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n },\n {\n \"issuen\": 631151,\n \"date\": \"2024-05-01 00:10:01\",\n \"email\": \"email@yandex.ru\",\n \"domain\": \"yourdomain.com\",\n \"x_track_id\": \"foo\" \n }\n ]\n}"},{"id":"ea0417f4-897f-449e-b973-65c73de4fa57","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/report/unsubscribe"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:11:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"94db4fe6-2b19-45e2-88ee-c5a8470c114e","name":"Неверный API ключ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/report/unsubscribe"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Feb 2024 15:12:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"c13b5e7f-80c1-4c36-be73-c81779dbae1d"},{"name":"Отчет за период","event":[{"listen":"test","script":{"id":"45261561-0658-4e6a-8b6e-472246a9558f","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8a425ab8-8cbc-4c35-9242-16deb884d634","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/issue/statistics?date_from=2023-11-01&date_to=2023-11-07×tamp_from=1706795600×tamp_to=1706831999&limit=5&cursor_next=563825&blist_id=1234","description":"

\n
В момент отправки письма происходит проверка получателя по активным стоп-листам, если имейл есть в соответствующем стопе, то значение счетчиков stop, fbl, bad будет инкрементировано.
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Описание
total	Общее количество запросов. Инкрементируется при запросе со стороны клиента.
send_ok	Количество успешно отправленных писем. Не учитывает cc и bcc заголовки
send_fail	Количество системных ошибок при отправке.
open_msg	Общее количество прочитанных писем.
open_msg_uniq	Уникальное количество прочитанных писем.
click_link	Общее количество переходов по ссылкам.
click_link_uniq	Уникальное количество переходов по ссылкам.
gen_ok	XML-рассылки. Генерация прошла успешно.
dup	XML-рассылки. Имейл является дублем в рамках пакета.
bad	Не является имейлом. Инкрементируется перед попыткой отправить.
fbl	Имейл ранее пожаловался на спам. Инкрементируется перед попыткой отправить.
stop	Имейл в стоп-листе (отписался, не валиден, либо был получен отлуп) Инкрементируется перед попыткой отправить.
trap	Имейл находится в базе спам-ловушек. Инкрементируется перед попыткой отправить.
bounce	Количество недоставленных писем. Чтобы узнать подробнее, смотрите отчет по недоставкам
spam	Количество жалоб. Чтобы узнать подробнее, смотрите отчет по жалобам

Дата начала

\n","type":"text/plain"},"key":"date_from","value":"2023-11-01"},{"description":{"content":"

Дата конца

\n","type":"text/plain"},"key":"date_to","value":"2023-11-07"},{"description":{"content":"

Дата начала timestamp

\n","type":"text/plain"},"key":"timestamp_from","value":"1706795600"},{"description":{"content":"

Дата конца timestamp

\n","type":"text/plain"},"key":"timestamp_to","value":"1706831999"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 100

\n","type":"text/plain"},"key":"limit","value":"5"},{"description":{"content":"

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"563825"},{"description":{"content":"

ID рассылки. Админский параметр

\n","type":"text/plain"},"key":"blist_id","value":"1234"}],"variable":[]}},"response":[{"id":"c08a6845-a7ab-4cab-b36e-15359a96a55e","name":"Успешный запрос","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/statistics?date_from=2023-11-01&date_to=2023-11-07&limit=5","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","statistics"],"query":[{"key":"date_from","value":"2023-11-01"},{"key":"date_to","value":"2023-11-07"},{"key":"timestamp_from","value":"1706795600","disabled":true},{"key":"timestamp_to","value":"1706831999","disabled":true},{"key":"limit","value":"5"},{"key":"cursor_next","value":"563825","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 12:04:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": { // Необязательный. Объект пагинации\n \"cursor_next\": 551302 // Значение для параметра cursor_next для перехода на следующую страницу\n },\n \"stat\": [ // Массив выпусков\n {\n \"date\": \"2024-02-01 00:00:01\", // Дата выпуска\n \"issuen\": 548708, // ID выпуска\n \"stat\": { // Статистика выпуска\n \"bad\": 10,\n \"bounce\": 5,\n \"click_link\": 0,\n \"click_link_uniq\": 0,\n \"dup\": 0,\n \"fbl\": 0,\n \"gen_ok\": 0,\n \"open_msg\": 0,\n \"open_msg_uniq\": 0,\n \"send_fail\": 0,\n \"send_ok\": 20252, \n \"stop\": 827,\n \"spam\": 0,\n \"total\": 21155,\n \"trap\": 0\n },\n \"status\": \"\"\n },\n {\n \"date\": \"2024-02-02 00:00:42\",\n \"issuen\": 549629,\n \"stat\": {\n \"bad\": 21,\n \"bounce\": 5,\n \"click_link\": 0,\n \"click_link_uniq\": 0,\n \"dup\": 0,\n \"fbl\": 0,\n \"gen_ok\": 0,\n \"open_msg\": 0,\n \"open_msg_uniq\": 0,\n \"send_fail\": 0,\n \"send_ok\": 21924,\n \"stop\": 1078,\n \"spam\": 0,\n \"total\": 23076,\n \"trap\": 0\n },\n \"status\": \"\"\n }\n ],\n \"status\": \"ok\",\n \"total\": { // Суммарная статиска по всем выпускам из массива stat\n \"bad\": 101,\n \"bounce\": 5,\n \"click_link\": 0,\n \"click_link_uniq\": 0,\n \"dup\": 0,\n \"fbl\": 23,\n \"gen_ok\": 0,\n \"open_msg\": 0,\n \"open_msg_uniq\": 0,\n \"send_fail\": 0,\n \"send_ok\": 114402,\n \"stop\": 5297,\n \"spam\": 0,\n \"total\": 120152,\n \"trap\": 7\n }\n}"},{"id":"987a80e0-f692-4406-95f9-f89e789851dd","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/issue/statistics?date_from=2023-11-01&date_to=2023-11-07","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","issue","statistics"],"query":[{"key":"date_from","value":"2023-11-01"},{"key":"date_to","value":"2023-11-07"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"8a425ab8-8cbc-4c35-9242-16deb884d634"},{"name":"Отчет по выпуску","id":"39c6d505-bb61-4190-9c5b-e587467df9ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v1/get_issue_stat?id=66633&id=66634","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v1","get_issue_stat"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

ID пакета, который вернулся в методе отправки

\n","type":"text/plain"},"key":"id","value":"66633"},{"key":"id","value":"66634"}],"variable":[]}},"response":[{"id":"0797cdd2-4b1d-4a00-968e-940af2f146d2","name":"Статистика пакетной отправки","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v1/get_issue_stat?key=XXX&id=66633&id=66634","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v1","get_issue_stat"],"query":[{"key":"key","value":"XXX"},{"key":"id","value":"66633","description":"ID пакета, который вернулся в методе отправки"},{"key":"id","value":"66634"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:15:19 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"\",\n \"stat\": \n [\n {\n \"status\": \"S018\",\n \"date\": \"2016-05-26 12:54:38\",\n \"issuen\": 123,\n \"stat\": \n {\n \"spam\": 0,\n \"send_ok\": 19046,\n \"send_fail\": 0,\n \"stop\": 2162,\n \"gen_ok\": 0,\n \"open_msg\": 198,\n \"bad\": 46,\n \"trap\": 10,\n \"click_link\": 0,\n \"dup\": 0,\n \"total\": 21687,\n \"fbl\": 423,\n \"bounce\": 4\n }\n },\n {\n \"status\": \"S018\",\n \"date\": \"2016-05-26 12:54:38\",\n \"issuen\": 456,\n \"stat\": \n {\n \"spam\": 0,\n \"send_ok\": 1,\n \"send_fail\": 0,\n \"stop\": 0,\n \"gen_ok\": 0,\n \"open_msg\": 0,\n \"bad\": 0,\n \"trap\": 0,\n \"click_link\": 0,\n \"dup\": 0,\n \"total\": 1,\n \"fbl\": 0,\n \"bounce\": 4\n }\n }\n ]\n}"}],"_postman_id":"39c6d505-bb61-4190-9c5b-e587467df9ed"}],"id":"978bd357-118d-47d1-96fb-6d08b4d4c07f","_postman_id":"978bd357-118d-47d1-96fb-6d08b4d4c07f","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Вебхуки","item":[{"name":"Webhook Единичная отправка","id":"9381971e-6b2d-4476-8614-8f1e68306b6c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"status\": \"ok\",\r\n \"messages\": [\r\n {\r\n \"email\": \"rctp_email@mail.com\",\r\n \"message_id\": \"1pyYDF-000130-Mr\",\r\n \"x_track_id\": \"foo\",\r\n \"status\": \"failed\",\r\n \"reason\": \"H=gmail-smtp-in.l.google.com [64.233.165.26] CV=yes: 550-5.1.1 The email account that you tried to reach does not exist. Please try\\\\n550-5.1.1 double-checking the recipient's email address for typos or\\\\n550-5.1.1 unnecessary spaces. Learn more at\\\\n550 5.1.1\",\r\n \"ttl_date\": \"2025-12-04\",\r\n \"created_at\": 1684157173\r\n },\r\n {\r\n \"email\": \"rctp_email2@mail.com\",\r\n \"message_id\": \"1pyYDH-0000kW-MA\",\r\n \"x_track_id\": \"foo\",\r\n \"status\": \"delivered\",\r\n \"created_at\": 1684157174\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"your-webhook-url.com/endpoint","description":"

Для того, чтобы активировать webhook, напишите в поддержку smtp@samotpravil.ru домен отправителя и url хука.

\n
Метод не выполняет повторные попытки, если ваш эндпоинт ответил ошибкой
\n

\n
Задержка от момента события до отправки вебхука может занимать до 15 минут. Если в течение 15 минут вы не получили вебхук, напишите в поддержку
\n

\n
В ответ ожидаем статус 200 OK, тело пустое
\n

Возможные значения переменной status

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Статус	Значение	Комментарий
accepted	Письмо принято к отправке	Cервер Samotpravil принял письмо к отправке. В случае, если письмо не может быть сразу доставлено, например ящик переполнен, будут производиться попытки доставить с интервалом от нескольких часов, до нескольких дней. На 10ую неудачную попытку вернётся статус failed.
delivered	Письмо доставлено	Cервер получателя вернул ответ 250 OK
failed	Доставка не удалась	Cервер получателя вернул ответ 5XX
open	Письмо открыли
click	Был клик по ссылке в письме
fbl	Подписчик пожаловался на письмо	Подписчик нажал нативную кнопку «Это спам»
unsubscribe	Подписчик отписался от рассылки	Подписчик, нажал нативную кнопку «Отписаться», которая инициирует срабатывание заголовка list-unsubscribe
duplicate	Дубль	Такой имейл уже есть в пакете

Подписчики, отправки на которых вернули статус failed, fbl или unsubscribe, добавляются в локальный стоп-лист. При следующей попытке отправить на них письмо вернётся ошибка 550 bounced check filter. Удалить имейл из стоп-листа можно соответствующим api методом.

Ниже представлен пример тела запроса, который сервер samotpravil.ru будет отправлять на ваш эндпоинт

\n
Если имейл из копии (CC) или скрытой копии (BCC) пожаловался или отписался от рассылки, то в теле вебхука будет указан только имейл из заголовка TO, и он же будет добавлен в стоп-лист
\n

Обратите внимание, что поле created_at возвращает timestamp в UTC+3

\n","urlObject":{"path":["endpoint"],"host":["your-webhook-url","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9381971e-6b2d-4476-8614-8f1e68306b6c"},{"name":"Webhook Пакетная отправка","id":"ca30a034-b7b2-4fe9-96b0-cd1b0daccb9d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"status\": \"ok\",\r\n \"xml_messages\": [\r\n {\r\n \"pack_id\": \"302251\", // ID пакетной отправки, если письмо отправлено пакетным методом\r\n \"external_id\": \"some_id_1776755427\", // ваш ID пакета, переданный в методе создания пакета\r\n \"email\": \"email1@domain.com\", // Имейл подписчика\r\n \"status\": \"accepted\", // Возможные значения в таблице ниже\r\n \"created_at\": 1615409261 // Время события - time stamp\r\n },\r\n {\r\n \"pack_id\": \"302251\",\r\n \"external_id\": \"some_id_1776755427\",\r\n \"email\": \"email2@domain.com\",\r\n \"status\": \"failed\",\r\n \"reason\": \"user not found\", // Причина недоставки письма. Передаётся для статуса failed\r\n \"ttl_date\": \"2025-12-04\", // Срок, до которого имейл будет в стоп-листе\r\n \"created_at\": 1615409261\r\n },\r\n {\r\n \"pack_id\": \"302251\",\r\n \"external_id\": \"some_id_1776755427\",\r\n \"email\": \"email3@domain.com\",\r\n \"status\": \"click\",\r\n \"click_link\": \"https://domain.com\", // Ссылка клика. Передаётся для статуса click\r\n \"created_at\": 1615409261\r\n },\r\n {\r\n \"pack_id\": \"1008507\",\r\n \"external_id\": \"some_id_1776755427\",\r\n \"email\": \"email4@domain.com\",\r\n \"status\": \"duplicate\", // Дубль. Имейл в пакете повторяется\r\n \"reason\": \"550 bounced check filter\",\r\n \"created_at\": 1746013020\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"your-webhook-url.com/endpoint","description":"

Для того, чтобы активировать webhook, напишите в поддержку smtp@samotpravil.ru домен отправителя и url хука.

\n
Максимальное количество объектов в xml_messages - 100 шт. То есть если ваша рассылка была отправлена на 1000 имейлов, мы отправим 10 вебхуков по 100 имейлов в каждом.
\n

\n
Метод не выполняет повторные попытки, если ваш эндпоинт ответил ошибкой
\n

\n
В ответ ожидаем статус 200 OK, тело пустое
\n

Обратите внимание, что поле created_at возвращает timestamp в UTC+3

\n","urlObject":{"path":["endpoint"],"host":["your-webhook-url","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ca30a034-b7b2-4fe9-96b0-cd1b0daccb9d"},{"name":"Webhook о деактивации рассылки","id":"492b3d5b-db39-48d5-baca-efaeeb3b9703","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"message\": \"blist id=123 was deactivated\"\r\n}","options":{"raw":{"language":"json"}}},"url":"your-webhook-url.com/endpoint","urlObject":{"path":["endpoint"],"host":["your-webhook-url","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"492b3d5b-db39-48d5-baca-efaeeb3b9703"}],"id":"32fdfef9-5236-4901-95f8-9a4bc5d8e073","_postman_id":"32fdfef9-5236-4901-95f8-9a4bc5d8e073","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Стоп-листы","item":[{"name":"Поиск имейла","id":"56ba4dd4-2f5a-4764-9b5c-434d76bcfc2d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Описание
ttl	Массив с датой автоматического выхода имейла из стопа
ttl.domain	Домен
ttl.date	Дата выхода из стопа для этого домена. Возможные значения: Дата yyyy-mm-dd 0 - имейл может быть удален только вручную
domains	Массив доменов, для которых искомый имейл находится в стопе
bounces	Массив отлупов (причины попадания в стоп-лист)
user_unsubscribe	Массив отписок (подписчик отписался от рассылок)
fbl_report	Массив жалоб (подписчик пожаловался на спам)

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","stop-list","search"],"host":["api.samotpravil.ru"],"query":[{"key":"email","value":"example@domain.com"}],"variable":[]}},"response":[{"id":"d3d69f29-2ecd-4759-be9f-f8c0f380055d","name":"Успешный ответ с TTL","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","search"],"query":[{"key":"email","value":"example@domain.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"ttl\": [\n {\n \"domain\":\"samotpravil.ru\",\n \"ttl_date\":\"2025-04-07\" // дата выхода имейла из стопа\n }\n ],\n \"domains\": [\n \"samotpravil.ru\"\n ],\n \"bounces\": [\n {\n \"date\": \"1697747101\",\n \"bounce\": \"some bounce text\"\n }\n ],\n \"user_unsubscribe\": [\n {\n \"date\": \"1697747101\",\n \"domain\": \"samotpravil.ru\"\n }\n ],\n \"fbl_report\": [\n {\n \"date\": \"1697747101\",\n \"domain\": \"samotpravil.ru\"\n }\n ]\n}"},{"id":"fce2f451-dfcb-477c-b407-9cd217def8c7","name":"Успешный ответ без TTL","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","search"],"query":[{"key":"email","value":"example@domain.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"ttl\": [\n {\n \"domain\": \"samotpravil.ru\",\n \"ttl_date\": \"0\" // имейл будет в стопе перманентно\n }\n ],\n \"domains\": [\n \"samotpravil.ru\"\n ],\n \"bounces\": [\n {\n \"date\": \"1697747101\",\n \"bounce\": \"some bounce text\"\n }\n ],\n \"user_unsubscribe\": [\n {\n \"date\": \"1697747101\",\n \"domain\": \"samotpravil.ru\"\n }\n ],\n \"fbl_report\": [\n {\n \"date\": \"1697747101\",\n \"domain\": \"samotpravil.ru\"\n }\n ]\n}"},{"id":"3c5d3d72-18d7-498c-88e6-0e9763bc62f8","name":"Имейл не найден","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","search"],"query":[{"key":"email","value":"example@domain.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"domains\": [],\n \"bounces\": [],\n \"user_unsubscribe\": [],\n \"fbl_report\": []\n}"},{"id":"f7e041fa-ff8b-4e58-b07c-945fc55cfaa1","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/search?email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","search"],"query":[{"key":"email","value":"example@domain.com"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"50cbb216-947e-43f0-b476-06f3484ed33b","name":"Невалидный запрос","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/search"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:30:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"56ba4dd4-2f5a-4764-9b5c-434d76bcfc2d"},{"name":"Удалить имейл","id":"e3357191-6c9f-4bb7-9651-e99cb63dc8bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/remove?mail_from=info@samotpravil.ru&email=example@domain.com","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","stop-list","remove"],"host":["api.samotpravil.ru"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}],"variable":[]}},"response":[{"id":"2d49af20-3677-43a9-aeac-de256b0d0db6","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/remove?mail_from=info@samotpravil.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","remove"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"OK\"\n}"},{"id":"6f6c5876-a367-4c12-a0a8-10b9543e6b37","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/remove?mail_from=info@samotpravil.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","remove"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"af609c37-9e58-461f-a452-5cc50b0ac5c9","name":"mail_from нет в списке разрешенных","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/remove?mail_from=info@mailguner.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","remove"],"query":[{"key":"mail_from","value":"info@mailguner.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:24:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"58"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"unregister mail_from domain\"\n}"},{"id":"bc473c66-1f8b-4a72-a50a-0a3505fd05f2","name":"Невалидный запрос","originalRequest":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/remove"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:30:22 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"e3357191-6c9f-4bb7-9651-e99cb63dc8bb"},{"name":"Добавить имейл","id":"cf6dbfae-04e1-4fcf-847e-2c977a4db3b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/add?mail_from=info@samotpravil.ru&email=example@domain.com","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","stop-list","add"],"host":["api.samotpravil.ru"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}],"variable":[]}},"response":[{"id":"e34a4f59-6686-41e5-8232-71c6d702a943","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/add?mail_from=info@samotpravil.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","add"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"OK\"\n}"},{"id":"8767f22b-2fe8-452d-a6d7-8e7fb00294dc","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/add?mail_from=info@samotpravil.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","add"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"aa654b2b-9bda-4b74-b40d-2fc77c73a375","name":"mail_from нет в списке разрешенных","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/stop-list/add?mail_from=info@samotpravil.ru&email=example@domain.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","stop-list","add"],"query":[{"key":"mail_from","value":"info@samotpravil.ru"},{"key":"email","value":"example@domain.com"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:27:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"58"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"unregister mail_from domain\"\n}"},{"id":"c53e1b64-e67b-4052-ac83-77111acd71ca","name":"Невалидный запрос","originalRequest":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:29:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data\"\n}"}],"_postman_id":"cf6dbfae-04e1-4fcf-847e-2c977a4db3b5"},{"name":"Список отписавшихся","id":"8c9baefc-e57b-4b28-9a3c-2e23189a9b9a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/unsubscribe?cursor_next=12345&limit=5","description":"

Метод возвращает стоп-лист имейлов, которые отписались от рассылки

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 50

\n","type":"text/plain"},"key":"limit","value":"5"}],"variable":[]}},"response":[{"id":"790d5916-0bdb-46a0-ae17-35050570a00b","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/unsubscribe"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 4574291\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"date\": \"2026-02-17 00:36:29\",\n \"email\": \"email1@mail.ru\",\n \"x_track_id\": \"d57af782a72261db1a07be37bccadd20eceb525d2547d31a1f07441759b498a3\",\n \"issuen\": 1457161,\n \"from_domain\": \"samotpravil.ru\"\n },\n {\n \"date\": \"2026-02-16 19:53:23\",\n \"email\": \"email2@mail.ru\",\n \"x_track_id\": \"7d0ea51621b96ba9c2b0dbcd52bdb46685dd8431d96998457b0fd9e80effd934\",\n \"issuen\": 1615303,\n \"from_domain\": \"samotpravil.ru\"\n }\n ]\n}"},{"id":"6b705937-688f-4bb3-874f-c3f802a6c4aa","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/unsubscribe"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"8c9baefc-e57b-4b28-9a3c-2e23189a9b9a"},{"name":"Список FBL","id":"0da81108-fec2-4da4-8f38-3fadb30442a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/fbl?cursor_next=12345&limit=5","description":"

Метод возвращает стоп-лист имейлов, которые пожаловались на рассылку

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 50

\n","type":"text/plain"},"key":"limit","value":"5"}],"variable":[]}},"response":[{"id":"8981e7e8-0b81-488d-966f-6fbdaedeed1a","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/fbl"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 4574291\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"date\": \"2026-02-17 00:36:29\",\n \"email\": \"email1@mail.ru\",\n \"x_track_id\": \"d57af782a72261db1a07be37bccadd20eceb525d2547d31a1f07441759b498a3\",\n \"issuen\": 1457161,\n \"from_domain\": \"samotpravil.ru\"\n },\n {\n \"date\": \"2026-02-16 19:53:23\",\n \"email\": \"email2@mail.ru\",\n \"x_track_id\": \"7d0ea51621b96ba9c2b0dbcd52bdb46685dd8431d96998457b0fd9e80effd934\",\n \"issuen\": 1615303,\n \"from_domain\": \"samotpravil.ru\"\n }\n ]\n}"},{"id":"a69392d0-e5d6-4d3a-82c8-8fe3caf7c3e0","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/fbl"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"0da81108-fec2-4da4-8f38-3fadb30442a4"},{"name":"Список Недоставок","id":"d0852f14-813e-42a4-b67c-6850ab7baf68","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/failed?cursor_next=12345&limit=5","description":"

Метод возвращает стоп-лист имейлов, на которые не удалась доставка с причинами недоставки

Необязательный параметр. Пагинация

\n","type":"text/plain"},"key":"cursor_next","value":"12345"},{"description":{"content":"

Необязательный параметр. Лимит объектов в массиве. Стандартно 50

\n","type":"text/plain"},"key":"limit","value":"5"}],"variable":[]}},"response":[{"id":"ca9671e1-737e-4512-9489-b700bfc33de4","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/failed"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:25:28 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"pagination\": {\n \"cursor_next\": 4574291\n },\n \"status\": \"ok\",\n \"report\": [\n {\n \"date\": \"2026-02-17 00:36:29\",\n \"email\": \"email1@mail.ru\",\n \"x_track_id\": \"d57af782a72261db1a07be37bccadd20eceb525d2547d31a1f07441759b498a3\",\n \"issuen\": 1457161,\n \"message\": \": 550 5.1.1 : user does not exist\",\n \"code\": 550,\n \"from_domain\": \"samotpravil.ru\"\n },\n {\n \"date\": \"2026-02-16 19:53:23\",\n \"email\": \"email2@mail.ru\",\n \"x_track_id\": \"7d0ea51621b96ba9c2b0dbcd52bdb46685dd8431d96998457b0fd9e80effd934\",\n \"issuen\": 1615303,\n \"message\": \"This is a permanent error. The following address(es) failed: email2@mail.ru host hotmail-com.olc.protection.outlook.com [52.101.68.24] SMTP error from remote mail server after pipelined sending data block: 550 5.7.1 Unfortunately, messages from [157.90.125.222] weren't sent. Please contact your Internet service provider since part of their network is on our block list (S3150). You can also refer your provider to http://mail.live.com/mail/troubleshooting.aspx#errors. [Name=Protocol Filter Agent][AGT=PFA][MxId=11BD0102CD9CD71B] [DB3PEPF0000885E.eurprd02.prod.outlook.com 2026-03-17T06:34:57.782Z 08DE80816C2678CE]\",\n \"code\": 550,\n \"from_domain\": \"samotpravil.ru\"\n }\n ]\n}"},{"id":"1b7688ca-1945-4d09-b6ac-cfabed1dbd76","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/failed"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"d0852f14-813e-42a4-b67c-6850ab7baf68"},{"name":"Создать задачу на экспорт","id":"2bfe3214-cd3e-46b8-b2da-6ca8305ceff3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export","description":"

Асинхронные методы на скачивание Стоп-листа по логину.

Данный метод создает задачу на экспорт стоп-листа и возвращает в ответе ссылку для последующего опроса и скачивания .csv файла в архиве

Метод на скачивание стоп-листа.

Необходимо обращаться с названием файла, который вернулся при создании задачи.

Данный метод отдает два успешных кода:

204 - файл еще не готов, нужно прийти позже
\n
200 - отдается архив с csv файлом.
\n

Ниже представлен код на Python для обработки и сохранения архива:

import requests as rq\nfrom io import BytesIO\nimport gzip\nimport time\n\n\ndef save_file(filename: str):\n    url = f\"https://api.samotpravil.ru/api/v2/stop-list/export/{filename}.gz\"\n\n    for i in range(60):\n        r = rq.get(url, headers=dict(authorization=\"XXX\"))\n        if r.status_code == 204:\n            time.sleep(1)\n            continue\n        elif r.status_code == 200:\n            fd = BytesIO(r.content)\n            with gzip.GzipFile(fileobj=fd, mode='rb') as gz:\n                csv = gz.read().decode(\"utf8\")\n                with open(filename, 'w', encoding='utf8') as f:\n                    f.write(csv)\n                break\n        else:\n            raise Exception(\"unexpeced status {}\".format(r.status_code))\n\nsave_file('export_stoplist.3540.20260317154453.796.csv')\n\n

Список статусов задач

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Статус	Описание
processing	Задача в обработке
ready	Файл готов к скачиванию
not_found	Задача не найден
failed	Не удалось создать файл для скачивания

Необязательный параметр для фильтрации задач по статусам

\n","type":"text/plain"},"key":"q","value":"failed"}],"variable":[]}},"response":[{"id":"3d999294-2070-400b-91d4-ee5018b6d7ab","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"tasks\": [\n {\n \"token\": \"some_export_name.csv.gz\",\n \"status\": \"ready\",\n \"created_at\": \"2026-03-17T12:44:54Z\",\n \"updated_at\": \"2026-03-17T12:45:01Z\"\n }\n ]\n}"},{"id":"fb6c5c0f-be4c-45d1-9246-1832e1da9270","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"b0de4829-2d5f-4145-ab05-c406bfd4ae28"},{"name":"Удалить задачу","id":"baae5c2c-76aa-48b3-a7f1-c9afb15b8494","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export/:token","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","stop-list","export",":token"],"host":["api.samotpravil.ru"],"query":[],"variable":[{"type":"any","value":"some_export_name.csv.gz","key":"token"}]}},"response":[{"id":"822b3a03-bd55-4839-af36-5c7f5962bb1c","name":"Успешный ответ","originalRequest":{"method":"DELETE","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"task cancelled\"\n}"},{"id":"d2d498cb-1563-4ab2-ba5e-d3bfcd98dc96","name":"Задача уже завершена","originalRequest":{"method":"DELETE","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"task is finished already\"\n}"},{"id":"e521b72a-3ce7-4d42-a702-712ef2e3761b","name":"Ошибка при завершении","originalRequest":{"method":"DELETE","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:28:18 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"30"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"failed to cancel task\"\n}"},{"id":"e4c1c3c3-33b9-409d-89fd-b60699c34038","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"url":"https://api.samotpravil.ru/api/v2/stop-list/export"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:22:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"baae5c2c-76aa-48b3-a7f1-c9afb15b8494"}],"id":"89b3f1b9-a142-44c2-8b41-e74f2acfe65f","_postman_id":"89b3f1b9-a142-44c2-8b41-e74f2acfe65f","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Домены","item":[{"name":"Список разрешенных доменов","id":"def0eb00-3660-4713-8bfe-accd2efc89b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/domains","urlObject":{"protocol":"https","path":["api","v2","blist","domains"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"4ea3bd97-c540-482b-9d4d-009250fbd58b","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/domains"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:12:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"42"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"domains\": [\n \"mailganer.com\"\n ]\n}"},{"id":"6f01d4c7-9341-45eb-b439-c1eaeba22963","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist/domains"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:11:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"def0eb00-3660-4713-8bfe-accd2efc89b6"},{"name":"Добавить домен","id":"372d5d44-eb09-4eda-8895-3dedc2fde511","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add","description":"

Для добавления домена с помощью API необходимо провести верификацию домена.

В DNS-записях также необходимо создать TXT-запись, в которой указать ключ верификации домена.

Значение ключа вам вернется в методе создания рассылки, либо вы можете получить его через Службу поддержки.

Проверить верификацию домена можно с помощью метода.

\n","urlObject":{"protocol":"https","path":["api","v2","blist","domains","add"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"e6242166-c3d6-4a80-ad54-23439acb57bf","name":"Успешный ответ","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:12:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"42"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"domain added\"\n}"},{"id":"fd3168ea-922c-40ec-9837-c9d068214c5c","name":"Домен уже добавлен","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:12:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"42"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"domain already trusted\"\n}"},{"id":"799b307b-8bde-4a71-b53a-d3ec825d4e79","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:11:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"ac90bdea-3deb-4cd3-b146-a1150932494b","name":"Требуется верификация домена","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:15:19 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"email domain verification failed\"\n}"},{"id":"2631482a-1f01-4d64-9107-883f5e084969","name":"Невалидный запрос","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": 11111\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:17:02 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"138"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data: json: cannot unmarshal number into Go struct field bListDomainsForm.Domain of type string\"\n}"},{"id":"167a9c7e-c04a-4b3d-ae89-4cdc63231ca6","name":"Нет поля domain","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:17:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"144"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data: Key: 'bListDomainsForm.Domain' Error:Field validation for 'Domain' failed on the 'required' tag\"\n}"}],"_postman_id":"372d5d44-eb09-4eda-8895-3dedc2fde511"},{"name":"Удалить домен","id":"9a51577c-4e58-4ec7-aef1-53d5530d66aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/remove","urlObject":{"protocol":"https","path":["api","v2","blist","domains","remove"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"781bac64-4385-4f08-a671-731b4c54347d","name":"Успешный ответ","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:12:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"42"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"domain removed\"\n}"},{"id":"2adb155d-7732-4d52-9aab-3efc20625c52","name":"Домен уже добавлен","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:12:58 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"42"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"message\": \"domain does not trusted\"\n}"},{"id":"e46cef4b-b006-4d9d-9caf-815ebd3aa2d9","name":"Ошибка авторизации","originalRequest":{"method":"GET","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:11:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"3a3d0874-c813-49b5-a19e-f2ebdb443d53","name":"Невалидный запрос","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": 11111\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:17:02 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"138"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data: json: cannot unmarshal number into Go struct field bListDomainsForm.Domain of type string\"\n}"},{"id":"5143fd4b-4c8b-4b80-a357-1912b01d14cc","name":"Нет поля domain","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/add"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Fri, 24 Nov 2023 14:17:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"144"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request data: Key: 'bListDomainsForm.Domain' Error:Field validation for 'Domain' failed on the 'required' tag\"\n}"}],"_postman_id":"9a51577c-4e58-4ec7-aef1-53d5530d66aa"},{"name":"Проверка верификации","id":"ddb3a718-c74e-41ce-ae8f-77e2ff585b1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\",\r\n \"client\": \"client_name\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/verify","description":"

client - опциональный параметр для владельцев Whitelabel.

Проверяет данные для вашего SPF и DKIM

\n","urlObject":{"protocol":"https","path":["api","v2","blist","domains","verify"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"5555aaed-ffed-4d59-8388-2a9dbf81957a","name":"Успешный ответ (верифицирован)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 20 Dec 2023 10:47:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"verification\": {\n \"verification_status\": true,\n \"spf_status\": true,\n \"dkim_status\": true,\n \"dmarc_status\": true,\n \"dns_status\": true\n }\n}"},{"id":"b68b232d-d9fd-4d6d-90b3-2b677366ca69","name":"Успешный ответ (не верифицирован)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 20 Dec 2023 10:47:53 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"136"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"verification\": {\n \"verification_status\": false,\n \"spf_status\": true,\n \"dkim_status\": true,\n \"dmarc_status\": true,\n \"dns_status\": false\n }\n}"},{"id":"4af4eb9d-4b94-44f7-8ece-78b9257b80cb","name":"Ошибка при проверке домена","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 20 Dec 2023 10:46:09 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"error verifying domain\"\n}"},{"id":"b8348d1e-8f38-453f-ad01-1bfce843fc0a","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"domain\": \"samotpravil.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/domains/verify"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 20 Dec 2023 10:44:59 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"ddb3a718-c74e-41ce-ae8f-77e2ff585b1a"}],"id":"d80fb4a3-5643-4525-9da8-85a69ff28e66","_postman_id":"d80fb4a3-5643-4525-9da8-85a69ff28e66","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Рассылки","item":[{"name":"Информация о рассылке","id":"1e5f2843-4bff-47a2-add7-45bcef51bba8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/blist?id=123","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Значение	Комментарий
id	123
name	some_name
active	true
check_stop_list	true
webhook_active	true
webhook_url	https://webhook.samotpravil.ru/webhook_endpoint
webhook_send_accepted_delivered	false	Отправлять вебхуки для статусов accepted и delivered в XML рассылках. Важно! При большой рассылке активация этого поля может создать большую нагрузку на ваш эндпоинт.
dns_key	XXX-XXXX-XXX-XXXX	DNS-ключ, который должен быть добавлен на домен
type_stop_list	domain	Активный тип клиентского стоп-листа. Возможные варианты: - domain (стоп-лист по домену) - blist (стоп-лист по рассылке)
dedicated_servers	array[] или null	Массив IP-адресов этой рассылки, если она использует выделенные IP

","urlObject":{"protocol":"https","path":["api","v2","blist"],"host":["api.samotpravil.ru"],"query":[{"description":{"content":"

ID Рассылки

\n","type":"text/plain"},"key":"id","value":"123"}],"variable":[]}},"response":[{"id":"95f688de-a7d7-4f9d-8724-0b714e50dc4c","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist?id=123","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist"],"query":[{"key":"id","value":"123","description":"ID Рассылки"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"mailing_ids\": [\n {\n \"id\": 123,\n \"name\": \"some_name\",\n \"active\": true,\n \"check_stop_list\": true,\n \"webhook_active\": true,\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\",\n \"webhook_send_accepted_delivered\": false,\n \"dns_key\": \"XXX-XXXX-XXX-XXXX\",\n \"type_stop_list\": \"domain\",\n \"dedicated_servers\": [\"111.222.333.444\", \"555.666.777.888\"]\n }\n ]\n}"},{"id":"91ec3165-782e-4b19-9a75-da9c4493f589","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist?id=123","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist"],"query":[{"key":"id","value":"123","description":"ID Рассылки"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:37:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"af0d1258-ce66-413e-af7b-7c6dec9e551d","name":"Неверный API-ключ","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/blist?id=123","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","blist"],"query":[{"key":"id","value":"123","description":"ID Рассылки"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"1e5f2843-4bff-47a2-add7-45bcef51bba8"},{"name":"Создать рассылку","id":"530de922-c273-41e2-8872-fd211c173847","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"some_name\",\n \"check_stop_list\": true, // Включить проверку по глобальному стоп-листу\n \"webhook_active\": true, // Включить Webhook\n \"web_hook_send_accepted_delivered\": false, // Отправлять статусы accepted и delivered на Webhook. Обратите внимание, данных статусов может быть много, и они могут приходить массово при большой отправке писем.\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\",\n \"webhook_send_xml_failed_global\": true // Включить отправку имейлов в глобальном стоп-листе на Webhook по XML отправкам. Данная фича активируется только по согласованию\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/create","urlObject":{"protocol":"https","path":["api","v2","blist","create"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"cef9bc7c-ae6c-4f6a-aa4c-e9a3276a1ed0","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"some_name\",\n \"check_stop_list\": true, // Включить проверку по глобальному стоп-листу\n \"webhook_active\": true, // Включить Webhook\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"mailing_ids\": [\n {\n \"id\": 123,\n \"name\": \"some_name\",\n \"active\": true,\n \"check_stop_list\": true,\n \"webhook_active\": true,\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\",\n \"webhook_send_accepted_delivered\": false,\n \"dns_key\": \"XXX-XXXX-XXX-XXXX\",\n \"type_stop_list\": \"domain\",\n \"dedicated_servers\": [\"111.222.333.444\", \"555.666.777.888\"]\n }\n ]\n}"},{"id":"55f71600-6f94-4b3d-b8fd-9f3a4442a3de","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"some_name\",\n \"check_stop_list\": true, // Включить проверку по глобальному стоп-листу\n \"webhook_active\": true, // Включить Webhook\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/create"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:37:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"2e329a63-db37-45f6-ba5e-87dc90b5c473","name":"Неверный API-ключ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"name\": \"some_name\",\n \"check_stop_list\": true, // Включить проверку по глобальному стоп-листу\n \"webhook_active\": true, // Включить Webhook\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/create"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"530de922-c273-41e2-8872-fd211c173847"},{"name":"Обновить рассылку","id":"6b19431b-f85e-446f-b62c-1c42f6dc6dd2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"id\": 1234,\n \"active\": false, \n \"name\": \"some name\",\n \"check_stop_list\": false, // управление глобальным стоп-листом\n \"webhook_active\": true, // управление вебхуком\n \"web_hook_send_accepted_delivered\": false, // Отправлять статусы accepted и delivered на Webhook. Обратите внимание, данных статусов может быть много, и они могут приходить массово при большой отправке писем.\n \"webhook_url\": \"https://webhook.samotpravil.ru/update\",\n \"webhook_send_xml_failed_global\": true // Включить отправку имейлов в глобальном стоп-листе на Webhook по XML отправкам. Данная фича активируется только по согласованию\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/update","urlObject":{"protocol":"https","path":["api","v2","blist","update"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"608840c1-87f3-4e43-bf89-88d3d2b40eb9","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"id\": 1234,\n \"active\": false, \n \"name\": \"some name\",\n \"check_stop_list\": false, // управление глобальным стоп-листом\n \"webhook_active\": true, // управление вебхуком\n \"webhook_url\": \"https://webhook.samotpravil.ru/update\" \n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"mailing_ids\": [\n {\n \"id\": 123,\n \"name\": \"some_name\",\n \"active\": true,\n \"check_stop_list\": true,\n \"webhook_active\": true,\n \"webhook_url\": \"https://webhook.samotpravil.ru/webhook_endpoint\",\n \"webhook_send_accepted_delivered\": false,\n \"dns_key\": \"XXX-XXXX-XXX-XXXX\",\n \"type_stop_list\": \"domain\",\n \"dedicated_servers\": [\"111.222.333.444\", \"555.666.777.888\"]\n }\n ]\n}"},{"id":"5b31d13a-1ef3-4321-8fe0-bf9d8c976bd6","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"id\": 1234,\n \"active\": false, \n \"name\": \"some name\",\n \"check_stop_list\": false, // управление глобальным стоп-листом\n \"webhook_active\": true, // управление вебхуком\n \"webhook_url\": \"https://webhook.samotpravil.ru/update\" \n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/update"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:37:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"4bb6b0b3-d3d4-4917-8de4-aefb85da5f99","name":"Неверный API-ключ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{ \n \"id\": 1234,\n \"active\": false, \n \"name\": \"some name\",\n \"check_stop_list\": false, // управление глобальным стоп-листом\n \"webhook_active\": true, // управление вебхуком\n \"webhook_url\": \"https://webhook.samotpravil.ru/update\" \n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/blist/update"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:39:16 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"6b19431b-f85e-446f-b62c-1c42f6dc6dd2"},{"name":"Информация об IP-адресе","id":"2b7d3116-4c04-4119-910e-a6c3b31f6467","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/ip","description":"

Метод возвращает массив IP-адресов, с которых производится отправка писем.

Данная группа методов доступна только клиентам White label

\n","_postman_id":"da1cbc12-04bd-42a8-bd59-55ba1a773a1d","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Ключи","item":[{"name":"Получить информацию об API-ключе","id":"2e5fa91d-bafb-461f-bf36-8f13b48ee411","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey","urlObject":{"protocol":"https","path":["api","v2","authkey"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"16bd1819-5a68-424c-9c54-f6e714bba1ae","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:52:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"api_keys\": [\n {\n \"id\": 123,\n \"api_key\": \"XXXXXXXXXX\",\n \"check_ips\": true,\n \"allowed_ips\": [\n \"192.168.0.1\"\n ]\n }\n ]\n}"},{"id":"c66a81e0-d5f3-4d2b-a88d-b64d8c0ea204","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:51:31 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"e0c042c5-c14e-4297-b1a5-3fecc353d968","name":"Неверный API-ключ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:52:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"2e5fa91d-bafb-461f-bf36-8f13b48ee411"},{"name":"Создать API-ключ","id":"508c3cc5-5f20-49be-bb15-c4c6afe945a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey/create","urlObject":{"protocol":"https","path":["api","v2","authkey","create"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"e0a2b792-a709-4a3a-a498-caa5347908c5","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey/create"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:52:17 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"ok\",\n \"api_keys\": [\n {\n \"id\": 123,\n \"api_key\": \"XXXXXXXXXX\",\n \"check_ips\": true,\n \"allowed_ips\": [\n \"192.168.0.1\"\n ]\n }\n ]\n}"},{"id":"1a981f84-f8cd-4a9c-97b5-b129729dfc97","name":"Ошибка авторизации","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey/create"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:51:31 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"62"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"},{"key":"Www-Authenticate","value":"auth realm=\"SMTP Api KEY\""}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Authorization header is missing\"\n}"},{"id":"1a6e5885-1d9c-475f-adf8-1fd07ad74fee","name":"Неверный API-ключ","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"mailing_id\": 123, // ID рассылки\n \"check_ips\": true, // Включить доступ к ключу по IP адресу\n \"allowed_ips\": [\n \"192.168.0.1\"\n ] // Массив разрешенных IP адресов\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/authkey/create"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Tue, 13 Feb 2024 12:52:01 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"}],"_postman_id":"508c3cc5-5f20-49be-bb15-c4c6afe945a4"}],"id":"8b10fa40-90ca-4b6e-b449-e2ab1cd60acd","description":"

Данная группа методов доступна только клиентам White label

\n","_postman_id":"8b10fa40-90ca-4b6e-b449-e2ab1cd60acd","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Верстка","item":[{"name":"Проверить верстку","id":"47b4cfb0-6c22-40cc-87aa-743de4095e36","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"body\": \"HTML content\",\r\n \"checks\": [\r\n {\r\n \"category\": \"missingAltText\"\r\n },\r\n {\r\n \"category\": \"missingImageLink\"\r\n },\r\n {\r\n \"category\": \"missingCopyLink\"\r\n },\r\n {\r\n \"category\": \"overageImageWeight\",\r\n \"limit\": 500\r\n },\r\n {\r\n \"category\": \"unreachableWebLink\"\r\n },\r\n {\r\n \"category\": \"insufficientColorContrast\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/email/check","description":"

Метод проверяет HTML-письмо на соответствие ряду правил качества и доступности. Возвращает найденные проблемы по категориям.

Тело запроса (JSON)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обязательность	Описание
body	string	да	HTML-контент письма для проверки.
checks	array	да	Список проверок, которые требуется выполнить. Каждый объект должен содержать поле `category`, а некоторые — дополнительный параметр `limit`.

Поддерживаемые категории проверок

missingAltText — отсутствие alt-текста у изображений
\n
missingImageLink — изображения без ссылки
\n
missingCopyLink — текстовые элементы без ссылок
\n
overageImageWeight — превышение допустимого веса изображений (использует limit в КБ)
\n
unreachableWebLink — недоступные внешние ссылки
\n
insufficientColorContrast — недостаточный контраст цветов
\n

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

{\n  \"body\": \"HTML content\",\n  \"checks\": [\n    { \"category\": \"missingAltText\" },\n    { \"category\": \"missingImageLink\" },\n    { \"category\": \"missingCopyLink\" },\n    { \"category\": \"overageImageWeight\", \"limit\": 500 },\n    { \"category\": \"unreachableWebLink\" },\n    { \"category\": \"insufficientColorContrast\" }\n  ]\n}\n\n

Ответы

Успех (200)

Возвращает объект с результатами проверок. Пример (сокращённо):

{\n  \"status\": \"ok\",\n  \"results\": [\n    { \"category\": \"missingAltText\", \"items\": [/*...*/] },\n    { \"category\": \"overageImageWeight\", \"items\": [/*...*/] }\n  ]\n}\n\n

Валидация — это проверка имейла на соответствие требованиям к адресам электронной почты, на которые можно отправлять рассылки.

Валидный имейл — это реально существующий и действующий адрес электронной почты.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обязательность	Описание
email	string	да	Имейл, по которому был сделал запрос
status	string	да	Статус имейла. Возможные варианты: unknown - статус неизвестен valid - имейл валиден not valid - имейл невалиден
is_valid	bool	нет	Булевый ответ является ли имейл валидным.

","urlObject":{"protocol":"https","path":["api","v2","emails","validate",""],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"f73d4a59-4111-4cae-a166-c191b989c49e","name":"Успешный ответ Валдиен","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/validate/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"example@mail.com\",\n \"status\": \"valid\", // Возможные статусы: unknown / valid / not valid\n \"is_valid\": true // Необязательный параметр. Отсутствует, если \"status\": \"unknown\"\n}"},{"id":"fe038bfe-8714-47f2-8522-608451d8aa1f","name":"Успешный ответ Невалиден","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/validate/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"example@mail.com\",\n \"status\": \"not valid\", // Возможные статусы: unknown / valid / not valid\n \"is_valid\": false // Необязательный параметр. Отсутствует, если \"status\": \"unknown\"\n}"},{"id":"c1130950-b7b3-46dc-bd21-89e6f8d32379","name":"Успешный ответ Неизвестен","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/validate/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"email\": \"example@mail.com\",\n \"status\": \"unknown\", // Возможные статусы: unknown / valid / not valid\n}"}],"_postman_id":"d651e381-f025-474b-a772-28734044a06b"},{"name":"Стандартизация","id":"fc9ee52a-b896-483a-84e3-432f74e1300e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[{"key":"Mg-Api-Key","value":"XXX","description":"

API-ключ Mailganer

\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail,ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/clean/","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Обязательность	Описание
email	string	да	Имейл, по которому был сделал запрос
corrected	string	да	Исправленный имейл
local	string	да	Локальная часть (до собаки @)
domain	string	да	Домен имейла
type	string	да	personal - личный (@mail.ru, @yandex.ru) corp - корпоративный (@myshop.ru) role - «ролевой» (info@, support@) temp - одноразовый (@temp-mail.ru)

","urlObject":{"protocol":"https","path":["api","v2","emails","clean",""],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"4fb2d5a6-f820-4f35-b895-a1d563f397e1","name":"Успешный ответ Исправлен","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail,ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/clean/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"email\": \"example@mail,ru\",\n \"corrected\": \"email@mail.ru\",\n \"local\": \"email\",\n \"domain\": \"mail.ru\",\n \"type\": \"personal\"\n }\n]"}],"_postman_id":"fc9ee52a-b896-483a-84e3-432f74e1300e"},{"name":"Активность","id":"cda16cfa-582f-45c9-81ea-93c0cc8c2cd8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"example@mail.ru\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/emails/activity/","description":"

Активность имейла - это метод, позволяющий получить информацию о том, как данный подписчик взаимодействует со своей почтой.

Данные предоставляются в обезличенном формате на основе сборной аналитики клиентов сервиса.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Поле	Тип	Описание
timestamp	string	Дата последнего взаимодйствия с письмами в формате Timestamp
activity_category	string	Категория подписчика

Описание категорий подписчиков

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Категория	Описание
A	Читал и переходил по письмам за последние 15 дней
B	Читал и переходил по письмам за последние 30 дней
C	Читал, но не переходил по письмам за последние 30 дней
D	Получал, но не читал письма
F	Жаловался на спам за последние 15 дней
U	Нет данных

","urlObject":{"protocol":"https","path":["api","v2","emails","activity",""],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"7c8c5f5f-8720-4b23-9d8e-fde732fbccdb","name":"Успешный ответ","originalRequest":{"method":"POST","header":[],"url":{"raw":"https://api.samotpravil.ru/api/v2/emails/validate/?email=example@mail.com","protocol":"https","host":["api.samotpravil.ru"],"path":["api","v2","emails","validate",""],"query":[{"key":"email","value":"example@mail.com"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"timestamp\": \"1747992111\",\n \"activity_category\": \"A\"\n}"}],"_postman_id":"cda16cfa-582f-45c9-81ea-93c0cc8c2cd8"}],"id":"db88a3a3-1202-46e6-b603-d78de2bd6f7e","description":"

Данная группа методов платная и доступна по запросу. Напишите на support@samotpravil.ru

\n","_postman_id":"db88a3a3-1202-46e6-b603-d78de2bd6f7e","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Конструктор писем","item":[],"id":"a7492d63-2896-42c2-90f9-c0db064d1b56","description":"

Что это?

Установите наш конструктор писем в свой интерфейс. Конструктор даст вам возможность создавать шаблоны писем с нуля без знания html и верстки.

Чтобы подключить сервис, напишите нам в поддержку support@samotpravil.ru

Описание как установить сервис:

Установка

Выполните этот код в командной строке:

$ npm i @SamotpravilHtmlBuilder/SamotpravilHtmlBuilder@1.0.74-alpha.1 -save\n\n

Добавьте SamotpravilHtmlBuilder plugin в ваш App config.

Для сборщика Webpack

Импорт пакета:

const SamotpravilHtmlBuilder = require('@SamotpravilHtmlBuilder/SamotpravilHtmlBuilder/webpack')\n\n

Определение пакета в приложении:

module.exports = {\n    plugins: [\n        new SamotpravilHtmlBuilder(),\n    ]\n}\n\n

Для сборщика Vite

Импорт пакета:

import SamotpravilHtmlBuilder from 'SamotpravilHtmlBuilder/vite'\n\n

Определение пакета в приложении:

export default defineConfig({\n    plugins: [SamotpravilHtmlBuilder()],\n})\n\n

Инициализация

Импортируйте SamotpravilHtmlBuilder plugin в вашем компоненте:

import * as SamotpravilHtmlBuilderfrom \"@SamotpravilHtmlBuilder/SamotpravilHtmlBuilder\"\n\n

Параметры инициализации плагина содержат параметр getAuthToken. В него должна быть передана функция, которая запрашивает авторизационный OAuth токен по Client ID и Client Secret.

Получение OAuth токена на бэкенде

curl --location 'https://api.samotpravil.ru/oauth/token' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'client_id=*******' \\\n--data-urlencode 'client_secret=*******' \\\n--data-urlencode 'grant_type=client_credentials'\n\n

Создание сущности SamotpravilHtmlBuilder plugin

SamotpravilHtmlBuilder.init({\n    getAuthToken: getAuthToken,\n    element: \"#test\",\n    content: {\n        title: \"Email subject\",\n        html: `КОД_ПИСЬМА`,\n    },\n    config: { }\n}).then(instance => {  })\n\n

\n","_postman_id":"a7492d63-2896-42c2-90f9-c0db064d1b56","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}},{"name":"Поддержка","item":[{"name":"Список обращений","id":"89d9ec9a-17dd-4c27-bf97-daed0c8d2db4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","tickets"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"15412556-83b0-4036-9977-a609cde64f6d","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": 2992803,\r\n \"subject\": \"привет\",\r\n \"client_id\": 15341,\r\n \"client_name\": \"Лащук Василий\",\r\n \"assignee_id\": 2,\r\n \"channel_id\": null,\r\n \"group\": 2,\r\n \"created_at\": \"2021-04-29 11:31:23\",\r\n \"last_updated_at\": \"2021-04-29 12:47:30\",\r\n \"channel_email\": null,\r\n \"active_sla\": [\r\n {\r\n \"type\": \"close\",\r\n \"date\": \"2021-04-29 13:35:04\"\r\n },\r\n {\r\n \"type\": \"first_reply\",\r\n \"date\": \"2021-04-29 18:01:08\"\r\n }\r\n ],\r\n \"ticket_fields\": [\r\n {\r\n \"id\": 25,\r\n \"name\": \"Жалоба\",\r\n \"value\": null\r\n },\r\n {\r\n \"id\": 37,\r\n \"name\": \"Причина обращений\",\r\n \"value\": \"39\"\r\n }\r\n ],\r\n \"tags\": [\r\n {\r\n \"name\": \"Важный\"\r\n },\r\n {\r\n \"name\": \"Холодный\"\r\n }\r\n ],\r\n \"status\": 2,\r\n \"priority\": \"medium\",\r\n \"type\": \"question\",\r\n \"last_comment\": \"У меня появилась ошибка\",\r\n \"remind_at\": null,\r\n \"rights\": \"read\"\r\n }\r\n]"}],"_postman_id":"89d9ec9a-17dd-4c27-bf97-daed0c8d2db4"},{"name":"Отдельное обращение","id":"8315de6d-3d4c-4f54-8a1b-9bd86ff5a076","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets/:id/","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","tickets",":id",""],"host":["api.samotpravil.ru"],"query":[],"variable":[{"description":{"content":"

ID обращения

\n","type":"text/plain"},"type":"any","value":"123456","key":"id"}]}},"response":[{"id":"7de92035-b75c-4afe-84a1-6cfb15f74295","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\r\n \"id\": 2992803,\r\n \"subject\": \"привет\",\r\n \"client_id\": 15341,\r\n \"client_name\": \"Лащук Василий\",\r\n \"assignee_id\": 2,\r\n \"channel_id\": null,\r\n \"group\": 2,\r\n \"created_at\": \"2021-04-29 11:31:23\",\r\n \"last_updated_at\": \"2021-04-29 12:47:30\",\r\n \"channel_email\": null,\r\n \"active_sla\": [\r\n {\r\n \"type\": \"close\",\r\n \"date\": \"2021-04-29 13:35:04\"\r\n },\r\n {\r\n \"type\": \"first_reply\",\r\n \"date\": \"2021-04-29 18:01:08\"\r\n }\r\n ],\r\n \"ticket_fields\": [\r\n {\r\n \"id\": 25,\r\n \"name\": \"Жалоба\",\r\n \"value\": null\r\n },\r\n {\r\n \"id\": 37,\r\n \"name\": \"Причина обращений\",\r\n \"value\": \"39\"\r\n }\r\n ],\r\n \"tags\": [\r\n {\r\n \"name\": \"Важный\"\r\n },\r\n {\r\n \"name\": \"Холодный\"\r\n }\r\n ],\r\n \"status\": 2,\r\n \"priority\": \"medium\",\r\n \"type\": \"question\",\r\n \"last_comment\": \"У меня появилась ошибка\",\r\n \"remind_at\": null,\r\n \"rights\": \"read\"\r\n}"}],"_postman_id":"8315de6d-3d4c-4f54-8a1b-9bd86ff5a076"},{"name":"Создать обращение","id":"ce8d45fa-78da-48e6-aca7-cbd816b1d251","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"subject\": \"\",\r\n \"message\": \"\",\r\n \"client_name\": \"Иван\",\r\n \"client_email\": \"superivan@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/tickets","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","tickets"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"6decad03-a02b-406c-a7ed-3b6c5b87b63f","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": 2992803,\r\n \"subject\": \"привет\",\r\n \"client_id\": 15341,\r\n \"client_name\": \"Лащук Василий\",\r\n \"assignee_id\": 2,\r\n \"channel_id\": null,\r\n \"group\": 2,\r\n \"created_at\": \"2021-04-29 11:31:23\",\r\n \"last_updated_at\": \"2021-04-29 12:47:30\",\r\n \"channel_email\": null,\r\n \"active_sla\": [\r\n {\r\n \"type\": \"close\",\r\n \"date\": \"2021-04-29 13:35:04\"\r\n },\r\n {\r\n \"type\": \"first_reply\",\r\n \"date\": \"2021-04-29 18:01:08\"\r\n }\r\n ],\r\n \"ticket_fields\": [\r\n {\r\n \"id\": 25,\r\n \"name\": \"Жалоба\",\r\n \"value\": null\r\n },\r\n {\r\n \"id\": 37,\r\n \"name\": \"Причина обращений\",\r\n \"value\": \"39\"\r\n }\r\n ],\r\n \"tags\": [\r\n {\r\n \"name\": \"Важный\"\r\n },\r\n {\r\n \"name\": \"Холодный\"\r\n }\r\n ],\r\n \"status\": 2,\r\n \"priority\": \"medium\",\r\n \"type\": \"question\",\r\n \"last_comment\": \"У меня появилась ошибка\",\r\n \"remind_at\": null,\r\n \"rights\": \"read\"\r\n }\r\n]"}],"_postman_id":"ce8d45fa-78da-48e6-aca7-cbd816b1d251"},{"name":"Создать обращение на выделенный IP","id":"65221dc2-ce58-4673-b9d4-8596135ebaab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"subject\": \"Заявка на выделенный IP\",\r\n \"cooment\": \"\", // комментарий к заявке\r\n \"type\": \"standard\", // b2b, custom\r\n \"speed\": \"standard\", // fast - быстрая скорость отправки / standard - обычная скорость отправки\r\n \"region\": \"ru\" // ru, kz, uz \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/tickets","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}},"urlObject":{"protocol":"https","path":["api","v2","tickets"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"ab3729d9-7017-45db-9baa-b3fdceecc3fa","name":"Успешный ответ","originalRequest":{"method":"GET","header":[],"url":"https://api.samotpravil.ru/api/v2/tickets"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"[\r\n {\r\n \"id\": 2992803,\r\n \"subject\": \"Заявка на выделенный IP\",\r\n \"client_id\": 15341,\r\n \"client_name\": \"Иван\",\r\n \"assignee_id\": 2,\r\n \"channel_id\": null,\r\n \"group\": 2,\r\n \"created_at\": \"2021-04-29 11:31:23\",\r\n \"last_updated_at\": \"2021-04-29 12:47:30\",\r\n \"channel_email\": null,\r\n \"active_sla\": [\r\n {\r\n \"type\": \"close\",\r\n \"date\": \"2021-04-29 13:35:04\"\r\n },\r\n {\r\n \"type\": \"first_reply\",\r\n \"date\": \"2021-04-29 18:01:08\"\r\n }\r\n ],\r\n \"ticket_fields\": [\r\n {\r\n \"id\": 25,\r\n \"name\": \"Жалоба\",\r\n \"value\": null\r\n },\r\n {\r\n \"id\": 37,\r\n \"name\": \"Причина обращений\",\r\n \"value\": \"39\"\r\n }\r\n ],\r\n \"tags\": [\r\n {\r\n \"name\": \"Важный\"\r\n },\r\n {\r\n \"name\": \"Холодный\"\r\n }\r\n ],\r\n \"status\": 2,\r\n \"priority\": \"medium\",\r\n \"type\": \"question\",\r\n \"last_comment\": \"

Заявка на выделенный сендер

Сервер Standard с Увеличенной скоростью отправки
Сервер Standard со Стандартной скоростью отправки

Bad Request (400)

Отчет о всех пришедших жалобах за этот день

Для работы этого функционала подключите обработку fbl и настройте переадресацию отчетов на fbl@samotpravil.ru

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

\n E000\n

\n E201\n no data found\n

\n E201\n error report param date format YYYY-MM-DD\n

Отчет о всех недоставленных письмах за этот день

\n \n \n \n \n 550\n \n : 452-4.2.2 The email account that you tried to reach is over quota. Please direct 452-4.2.2 the recipient to 452 4.2.2 https://support.google.com/mail/?p=OverQuotaTemp l25-20020a9d7099000000b006b4541efe04si1265484otj.247 - gsmtp: retry timeout exceeded]]>\n \n \n \n

\n E000\n

\n E201\n no data found\n

\n E201\n error report param date format YYYY-MM-DD\n

Данный метод следует считать устаревшим. Используйте Недоставки по выпуску https://documentation.samotpravil.ru/#f7a7690a-ad7c-4cc0-ac03-301200259199

ID пакета, который вернулся в методе отправки

\n \n // имейл\n reject_code\n // ответ сервера\n \n ...\n

Данный метод следует считать устаревшим. Используйте Недоставки по выпуску https://documentation.samotpravil.ru/#9b28ba17-7fd4-4e80-b647-c9baf9d2d979

ID пакета, который вернулся в методе отправки

\n \n \n \n ...\n

Код	Описание
E000	Неверный API ключ
E001	Не передан URL
E002	Не передан pack_id
E003	Информация о пакете не найдена
E004	Недостаточно трафика
E005	Не оплачен тариф
E006	Некорректные данные в пакете
S001	Пакет не был найден по указанному URL
S002	Пакет загружен на сервер
S004	Пакет рассылается
S005	Пакет отправлен. Ожидаем удаление информации о пакете из системы.
S006	Во время отправки произошли ошибки
S007	Некорректный формат пакета
S008	Превышено время ожидания ответа сервера
S009	Пакет получен
S010	Пакет проверяется
S011	Пакет обрабатывается (формируются сообщения)
S012	Пакет поставлен в очередь на удаление
S013	Пакет удален. Рассылка сообщений прекращена.
S014	Пакет ожидает проверки
S015	Ошибка проверки пакета, неверно заполнены поля
S018	Пакет отправлен. Информация о пакете удалена.
S019	Пакет проверен. Будет разослан в указанное время.

\n SXXX\n

\", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

Название	Переменная	Тип	Обязательный	Комментарий
Отправитель	email_from	Строка	✔	Формат: ИмяОтправителя <ИмейлОтправителя>
Получатель	email_to	Строка	✔
Тема письма	subject	Строка	✔
Вёрстка письма	message_text	Строка	✔
Свои переменные	params	json-массив		Передайте пары переменная-значение. Значения должны быть string
Валидация имейла	check_stop_list	Булев		Включает проверку по стоп-листам
Проверка по локальному (клиентскому) стоп-листу	check_local_stop_list	Булев		Выключает проверку по локальному стоп-листу. По дефолту true. Для подключения данной фичи обратитесь в службу поддержки
X-Track-ID	x_track_id	Строка		Пользовательский ID. Должен быть уникальным для каждой отправки. Хорошая практика формирования X-Track-ID - `{{login}}-{{timestamp}}-{{your-id}}` login - ваш логин к SMTP, timestamp - временная метка запроса, your-id - любой понятный вам ID
Домен для DKIM	domain_for_dkim	Строка		Домен, которым подписать письмо. Если не указан, то домен берётся из email_from
Отслеживать открытия	track_open	Булев		Для работы необходимо передавать параметр x_track_id
Отслеживать клики	track_click	Булев		Для работы необходимо передавать параметр x_track_id
Домен треккинга	track_domain	Строка		Можете настроить свой домен трекинга
Свои заголовки	headers	json-массив		Передайте пары заголовок-значение
Ссылка отписки	params.sys_unsubscribe_url	Строка		Зарезервированная переменная ссылка отписки
Не рендерить переменные	raw	Булев		Позволяет использовать передать текст в сыром виде
Добавить вложение	attach_files	json-массив
Имя файла	attach_files.name	Строка
Контент файла	attach_files.filebody	Строка		Файл, закодированный в base64

","urlObject":{"protocol":"https","path":["api","v2","mail","send"],"host":["api.samotpravil.ru"],"query":[],"variable":[]}},"response":[{"id":"01292b73-99e7-4cb4-b7d6-5428b3e00490","name":"Успешная отправка","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

Текст сообщения {{ params.other }} link

Ссылка отписки

\", // Тело письма HTML\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным \n \"track_open\": true, // Отслеживать открытия. Для работы необходимо передавать параметр x_track_id\n \"track_click\": true, // Отслеживать переходы. Для работы необходимо передавать параметр x_track_id\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"user\": \"Вася\",\n \"other\": \"шмель\" \n },\n \"raw\": true, // Не рендерить переменные. Отображать их в сыром виде\n \"attach_files\": [ // Добавить вложение\n {\"name\": \"image1.png\", \"filebody\": \"base64\"},\n {\"name\": \"image2.png\", \"filebody\": \"base64\"}\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:29:27 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"Bad Api KEY, forbidden\"\n}"},{"id":"f17e1fe7-cc22-4d8d-97c7-2fddb889c075","name":"Не передано необходимое поле","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \",\n \"email_to\": \"samotpravil@mail.ru\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:24:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"255"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"bad request send mail data: Key: 'mailSendForm.Subject' Error:Field validation for 'Subject' failed on the 'required' tag\\nKey: 'mailSendForm.MessageText' Error:Field validation for 'MessageText' failed on the 'required' tag\"\n}"},{"id":"51713f26-ed8c-4457-8223-089c80338def","name":"Email получателя в стоп-листе","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

\", // Тело письма HTML\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным \n \"track_open\": true, // Отслеживать открытия\n \"track_click\": true, // Отслеживать переходы\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"user\": \"Вася\",\n \"other\": \"шмель\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"code\": 550,\n \"message\": \"error send mail: 550 bounced check filter\", // Подробнее о работе стоп-листов в статье: https://mailganer.com/ru/explanation/stop-listy-smtp\n \"ttl_date\":\"2025-07-31\" // дата выхода имейла из стопа\n}"},{"id":"3e064c05-9dcb-4a97-be56-79854d0d7951","name":"Невалидный имейл","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil+-11ЁЁ@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

\", // Тело письма HTML\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным \n \"track_open\": true, // Отслеживать открытия\n \"track_click\": true, // Отслеживать переходы\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"user\": \"Вася\",\n \"other\": \"шмель\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"code\": 553,\n \"message\": \"error send mail: smtp error, cmd: rcpt to: 553 bad email\"\n}"},{"id":"f9e9f321-53fa-49c3-b970-640ed24e16ce","name":"Попытка отправить с неавторизованного домена","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

\", // Тело письма HTML\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным \n \"track_open\": true, // Отслеживать открытия\n \"track_click\": true, // Отслеживать переходы\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"user\": \"Вася\",\n \"other\": \"шмель\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"code\": 501,\n \"message\": \"error send mail: smtp error, cmd: close: 501 from domain not trusted\"\n}"},{"id":"0938b91d-4325-4415-a16d-b748dac6a380","name":"Большое количество запросов","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email_from\": \"Samotpravil \", // Имя и имейл отправителя\n \"email_to\": \"samotpravil@mail.ru\", // Имейл получателя\n \"subject\": \"Привет {{ params.user }} 2\", // Тема письма\n \"message_text\": \"

Текст сообщения {{ params.other }} link

Ссылка отписки

\", // Тело письма HTML\n \"x_track_id\": \"bar\", // Ваш x_track_id\n \"check_local_stop_list\": true, // Включить проверку по локальным \n \"track_open\": true, // Отслеживать открытия\n \"track_click\": true, // Отслеживать переходы\n \"track_domain\": \"track.samotpravil.ru\", // Трекерный домен\n \"headers\": { // Кастомные заголовки\n \"foo1\": \"bar1\",\n \"foo2\": \"bar2\"\n },\n \"params\": { // Параметры для подстановки в тело письма\n \"user\": \"Вася\",\n \"other\": \"шмель\" \n }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.samotpravil.ru/api/v2/mail/send"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Date","value":"Wed, 21 Jun 2023 10:27:44 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=40"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"error\",\n \"message\": \"error send mail: throttling, service busy\"\n}"}],"_postman_id":"15015693-d4bd-4b55-a319-e8402d96d062"}],"id":"85242206-37ca-4856-91bc-7a4c9adc66f8","description":"

Здесь перечислены устаревшие методы, поддержка которых в скором времени будет прекращена.

\n","_postman_id":"85242206-37ca-4856-91bc-7a4c9adc66f8","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]},"isInherited":true,"source":{"_postman_id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","id":"7482e402-cba9-4b3b-92ea-25ee07b9cb0d","name":"СамОтправил API Документация","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"XXX"}]}},"event":[{"listen":"prerequest","script":{"id":"d0dd3787-b521-4049-818f-e8fec089153d","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"4665a9fc-25f1-4a1c-bd80-14d091567b88","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"smtp_api_key","value":"XXX"},{"key":"host","value":"api.samotpravil.ru"},{"key":"xml_status_table","value":""},{"key":"delivery_status_table","value":"| Статус | Значение | Комментарий |\n| --- | --- | --- |\n| accepted | Письмо принято к отправке | Cервер Samotpravil принял письмо к отправке. В случае, если письмо не может быть сразу доставлено, например ящик переполнен, будут производиться попытки доставить с интервалом от нескольких часов, до нескольких дней. На 10ую неудачную попытку вернётся статус failed. |\n| delivered | Письмо доставлено | Cервер получателя вернул ответ 250 OK |\n| failed | Доставка не удалась | Cервер получателя вернул ответ 5XX |\n| open | Письмо открыли | |\n| click | Был клик по ссылке в письме | |\n| fbl | Подписчик пожаловался на письмо | Подписчик нажал нативную кнопку «Это спам» |\n| unsubscribe | Подписчик отписался от рассылки | Подписчик, нажал нативную кнопку «Отписаться», которая инициирует срабатывание заголовка list-unsubscribe |\n| duplicate | Дубль | Такой имейл уже есть в пакете |"}]}

Готовые библиотеки

Авторизация

Лимиты

Лимиты на запросы

Лимиты на отправки

Лимиты на создание пакетов

Лимит на размер письма

Настройки

Треккинг открытий и кликов

Популярные ошибки

Кастомный Return-Path

Telnet

Postfix

Exim

SSMTP

Python

Пример XML-пакета

Структура объекта users[]

Структура объекта nested_array[]

Структура объекта string_array[]

Возможные значения переменной status

Тело запроса (JSON)

Поддерживаемые категории проверок

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

Ответы

Успех (200)

Что это?

Установка

Для сборщика Webpack

Для сборщика Vite

Инициализация

Получение OAuth токена на бэкенде

Создание сущности SamotpravilHtmlBuilder plugin

Bad Request (400)