Общая статистика

С помощью API вы получить расширенную статистику отправки писем.
Отправьте GET запрос на URL http://api.mailhandler.ru/stat/reports/events-report/.
Запрос может содержать следующие параметры:
Название
Описание
Обязателен
Пример
date_from
Дата начала выборки в формате %d.%m.%Y
Нет
01.01.2017
date_to
Дата окончания выборки в формате %d.%m.%Y
Нет
31.01.2017
campaign_unique_id
Уникальный идентификатор рассылки
Нет
0f6fdbf5-b8d4-4694-b232-2a6879640942
event_types
Типы событий для выборки, по умолчанию - все. Вы можете одновременно передавать несколько типов событий, чтобы отфильтровать выборку по этим типам. Возможные типы: CREATED, SENT, OPENED, REDIRECTED, UNSUBSCRIBED, SOFTBOUNCED, HARDBOUNCED.
Нет
CREATED
Если вы не задаете временные рамки для выборки, отчет будет сформирован за прошлые 7 дней.
Пример запроса:
​http://api.mailhandler.ru/stat/reports/events-report/?date_from=01.01.2017&date_to=31.01.2017&event_types=SENT&event_types=OPENED​
В результате вы получите ответ в формате JSON с данными отчета.
Bash
Python
Пример получения списка объектов с помощью curl:
1
curl 'http://api.mailhandler.ru/stat/reports/events-report/' \ 
2
-X GET \ -H 'Accept: application/json' \ 
3
-H 'Content-Type: application/json' \ 
4
-H 'X-Secure-Token: <YOUR_TOKEN>'
Copied!
Пример получения списка объектов на python:
1
import requests 
2
​
3
def report():     
4
    headers = {         
5
        'X-Secure-Token': '<YOUR_TOKEN>',         
6
        'Accept': 'application/json',         
7
        'Content-Type': 'application/json',     
8
    }      
9
    response = requests.get('http://api.mailhandler.ru/stat/reports/events-report/',                              
10
                  json=data, 
11
                  headers=headers)     
12
    print(response.status_code)
Copied!
В случае успешного выполнения запроса вы получите ответ в формате JSON со статусом 200 OK
1
{
2
  "results": {
3
    "total": {
4
      "redirected_percent": 0,
5
      "opened": 10,
6
      "opened_percent": "90.9",
7
      "softbounced_percent": 0,
8
      "unsubscribed_percent": 0,
9
      "hardbounced_percent": 0,
10
      "sent": 11
11
    },
12
    "data": [
13
      {
14
        "date": "01.01.2017",
15
        "opened": 0,
16
        "sent": 0
17
      },
18
      ...
19
      {
20
        "date": "07.01.2017",
21
        "opened": 0,
22
        "sent": 0
23
      }
24
    ]
25
  }
26
}
Copied!

Адреса для отправки писем - Previous

Добавление адресов

Next - Статистика

Статистика отказов от рассылок

Last modified 2yr ago

Copy link