Аккаунт
Выйти

Обзор

Интеграции

Руководство пользователя

Справочник API

Вебхуки

Статистика

Статистика по исходящим письмам сервера ключа; с ключом аккаунта — по всем серверам. Чтобы получить её по одному каналу, передайте messagestream.

Сводная статистика #

get

/stats

Итоги по исходящим письмам аккаунта за период. Отправленные, открытия и клики — количество событий; возвраты, отписки и жалобы — количество адресов, у которых они были.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Sent integer

Отправлено писем.
Bounced integer

Адресов с возвратом.
Opened integer

Открытий, включая повторные.
Clicked integer

Кликов, включая повторные.
Unsubscribed integer

Адресов, отписавшихся от писем. То же число приходит в поле Unsubsribed — это прежнее название с опечаткой, оно оставлено для совместимости; в новом коде читайте Unsubscribed.
SpamComplaints integer

Адресов, пожаловавшихся на спам.
BounceRate number

Bounced / Sent × 100, до сотых.
SpamComplaintsRate number

SpamComplaints / Sent × 100, до сотых.
OpenRate number

Opened / Sent × 100, до сотых.
ClickRate number

Clicked / Sent × 100, до сотых.

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

curl "https://api.haskimail.ru/stats?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Sent": 615,
  "Bounced": 64,
  "Opened": 166,
  "Clicked": 72,
  "Unsubscribed": 3,
  "Unsubsribed": 3,
  "SpamComplaints": 10,
  "BounceRate": 10.41,
  "SpamComplaintsRate": 1.63,
  "OpenRate": 26.99,
  "ClickRate": 11.71
}

Отправленные по дням #

get

/stats/sends

Количество отправленных писем по дням.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Days array

Значения по дням, в порядке возрастания даты. Дней без событий в списке нет.
Days[].Date string

Дата, YYYY-MM-DD.
Days[].Sent integer

Отправлено писем.

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

curl "https://api.haskimail.ru/stats/sends?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Days": [
    {
      "Date": "2026-10-01",
      "Sent": 140
    },
    {
      "Date": "2026-10-02",
      "Sent": 160
    },
    {
      "Date": "2026-10-03",
      "Sent": 95
    }
  ]
}

Возвраты по дням #

get

/stats/bounces

Количество жёстких и мягких возвратов по дням.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Days array

Значения по дням, в порядке возрастания даты. Дней без событий в списке нет.
Days[].Date string

Дата, YYYY-MM-DD.
Days[].HardBounce integer

Жёстких возвратов.
Days[].SoftBounce integer

Мягких возвратов.

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

curl "https://api.haskimail.ru/stats/bounces?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Days": [
    {
      "Date": "2026-10-01",
      "HardBounce": 12,
      "SoftBounce": 3
    },
    {
      "Date": "2026-10-02",
      "HardBounce": 9,
      "SoftBounce": 0
    }
  ]
}

Жалобы на спам по дням #

get

/stats/spam

Количество жалоб на спам по дням.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Days array

Значения по дням, в порядке возрастания даты. Дней без событий в списке нет.
Days[].Date string

Дата, YYYY-MM-DD.
Days[].SpamComplaint integer

Жалоб на спам.

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

curl "https://api.haskimail.ru/stats/spam?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Days": [
    {
      "Date": "2026-10-01",
      "SpamComplaint": 2
    },
    {
      "Date": "2026-10-03",
      "SpamComplaint": 1
    }
  ]
}

Открытия по дням #

get

/stats/opens

Количество открытий по дням, включая повторные.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Days array

Значения по дням, в порядке возрастания даты. Дней без событий в списке нет.
Days[].Date string

Дата, YYYY-MM-DD.
Days[].Opens integer

Открытий.

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

curl "https://api.haskimail.ru/stats/opens?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Days": [
    {
      "Date": "2026-10-01",
      "Opens": 44
    },
    {
      "Date": "2026-10-02",
      "Opens": 46
    },
    {
      "Date": "2026-10-03",
      "Opens": 25
    }
  ]
}

Клики по дням #

get

/stats/clicks

Количество кликов по ссылкам по дням, включая повторные.

Заголовки запроса

Accept обязательный

application/json
X-Haskimail-Server-Token обязательный

Серверный API-ключ. Он есть в настройках сервера на вкладке «API-ключи».

Параметры строки запроса

fromdate

Начало периода, дата 2026-10-01. По умолчанию — месяц назад.
todate

Конец периода включительно, дата. По умолчанию — сегодня.
messagestream

ID канала. Без параметра — по всем каналам сервера ключа.

Ответ

Days array

Значения по дням, в порядке возрастания даты. Дней без событий в списке нет.
Days[].Date string

Дата, YYYY-MM-DD.
Days[].Clicks integer

Кликов.

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

curl "https://api.haskimail.ru/stats/clicks?fromdate=2026-10-01&todate=2026-10-07" \
  -X GET \
  -H "Accept: application/json" \
  -H "X-Haskimail-Server-Token: server token"

Пример ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "Days": [
    {
      "Date": "2026-10-01",
      "Clicks": 18
    },
    {
      "Date": "2026-10-02",
      "Clicks": 21
    },
    {
      "Date": "2026-10-03",
      "Clicks": 9
    }
  ]
}