С помощью API вы получить расширенную статистику отправки писем.
Отправьте GET
запрос на URL http://api.mailhandler.ru/stat/reports/events-report/.
Запрос может содержать следующие параметры:
Название | Описание | Обязателен | Пример |
| Дата начала выборки в формате | Нет | 01.01.2017 |
| Дата окончания выборки в формате | Нет | 31.01.2017 |
| Уникальный идентификатор рассылки | Нет |
|
| Типы событий для выборки, по умолчанию - все. Вы можете одновременно передавать несколько типов событий, чтобы отфильтровать выборку по этим типам. Возможные типы: | Нет |
|
Если вы не задаете временные рамки для выборки, отчет будет сформирован за прошлые 7 дней.
Пример запроса:
В результате вы получите ответ в формате JSON с данными отчета.
Пример получения списка объектов с помощью curl
:
curl 'http://api.mailhandler.ru/stat/reports/events-report/' \-X GET \ -H 'Accept: application/json' \-H 'Content-Type: application/json' \-H 'X-Secure-Token: <YOUR_TOKEN>'
Пример получения списка объектов на python
:
import requestsdef report():headers = {'X-Secure-Token': '<YOUR_TOKEN>','Accept': 'application/json','Content-Type': 'application/json',}response = requests.get('http://api.mailhandler.ru/stat/reports/events-report/',json=data,headers=headers)print(response.status_code)
В случае успешного выполнения запроса вы получите ответ в формате JSON со статусом 200 OK
{"results": {"total": {"redirected_percent": 0,"opened": 10,"opened_percent": "90.9","softbounced_percent": 0,"unsubscribed_percent": 0,"hardbounced_percent": 0,"sent": 11},"data": [{"date": "01.01.2017","opened": 0,"sent": 0},...{"date": "07.01.2017","opened": 0,"sent": 0}]}}