Методы ресурса SendStatistics

Метод:index

url: /mailer/sendstatistics

http-method: GET

Используется для получения списка рассылок.

Опциональные параметры

sort_field - значение по умолчанию: id. Доступные поля для сортировки: id.

Структура ответа

HTTP status code: 200.

При успешном выполнении запроса метод возвращает запрашиваемые данные в формате json.

Пример успешного ответа:

{
  "statistics": [
    {
      "id": 1,
      "letter_title": "letter_title"  
    },
    {
      "id": 2,
      "letter_title": "letter_title"
    },
    {
    ...
    }
  ]
}
Название параметра Тип Описание
id int Идентификатор рассылки.
letter_title string Тема письма.

Метод:view

url: /mailer/sendstatistics/[id]

http-method: GET

Используется для получения подробной статистики рассылки по уникальному идентификатору (id).

Опциональные параметры

fields - значение по умолчанию: ["id"]. Список доступных полей: id, common, open_time, click_statistic, domain_statistic, errors.

Структура ответа

HTTP status code: 200.

При успешном выполнении запроса метод возвращает запрашиваемые данные в формате json.

Пример успешного ответа:

{
  "id": 1,
  "common": {
    "count": 1,
    "delivered": 1,
    "bounce": 0,
    "opened": 1,
    "clicked": 0,
    "spam": 0,
    "unsubs": 0
  },
  "open_time": {
    "1474279200": 1
  },
  "click_statistic": [
    
  ],
  "domain_statistic": {
    "example.com": {
      "delivered": 1,
      "bounce": 0
    }
  },
  "errors": [
    
  ]
}
Название параметра Тип Описание
id int Идентификатор подписчика.
common object Общая статистика по рассылке. count - общее кол-во адресатов в рассылке. delivered - доставленно писем. bounce - откинуто писем. clicked - кол-во кликов. spam - закинуто в спам. unsubs - отписавшихся.
open_time object Статистика по времени открытия писем за последующие 2 дня после отправки.
click_statistic object Статистика кликов по ссылке.
domain_statistic object Статистика доменов, участвующих в рассылке.
errors object Статистика ошибок по рассылке.

Возможные коды ошибок параметра errors

Код ошибки Описание
0 Повторная попытка отправки
1 Почтовый сервер недоступен (501)
2 Попытка отправки проигнорирована
3 Сообщение разморожено по таймеру
4 Соединение запрещено
5 Сообщение заморожено
6 Домен не существует
7 Ошибка TLS при соединении
8 Ошибка TLS сессии
9 Закрытое соединение
10 Заморожен
11 Адрес не существует
12 Повторный таймаут
13 Почта не существует
14 CПАМ
15 Переполненый ящик
16 Mail.ru СПАМ
17 Отсутствие технических записей
18 Ошибка 18
44 Превышен интервал ожидания ответа
45 Отказ от приема
46 Почтовый сервер перегружен
51 Превышено время повторной отправки (501)
53 Заблокирован graylisting
110 Почтовый сервер недоступен (505)
111 Подозрение на graylisting
113 Blacklist

Ошибки

Код ответа Код ошибки Текст ответа Описание
400 20620 Invalid fields. Wrong parameters of string fields Переданны неправильные параметры строки fields.
404 Not found Статистики по рассылке по переданому идентификатору (id) не найдено.