Получение информации о подписчиках
GET https://mailganer.com/api/v2/emails/?email={{email}}&source={{source}}
Список параметров запроса
Альтернативный способ обратиться к данному методу - подставить mg_hash имейла в url. Например, https://mailganer.com/api/v2/emails/53158545763880e054b31ecbad2cf3265d4001d1/
Пример запросов
https://mailganer.com/api/v2/emails/https://mailganer.com/api/v2/emails/?email=test@example.com&source=49767Список параметров ответа (json)
Пример ответа в случае успеха (json)
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 45763880,
"mg_hash": "53158545763880e054b31ecbad2cf3265d4001d1",
"email": "test@mil.ru",
"source": 49767,
"email_status": "fixed", // статус подписчика подробно описан в таблице ниже
"bunce_log": "mailbox size limit exceeded", // причина несуществования имейла для статуса not_available
"corrected_email": "test@mail.ru", // для статуса fixed передаётся новый имейл, если исправлена опечатка
"name": "Федор",
"patronymic": "Федорович",
"surname": "Федоров",
"gender": 1, // 1 - муж, 2 - жен
"birthday": "01.01.1988",
"phone": "+79123456789",
"is_valid": true, // прошёл ли имейл платную валидацию?
"doi_is_delivery": true, // отправлялось ли письмо подтверждение подписки?
"doi_is_open": true, // было ли открыто письмо подтверждение подписки?
"doi_is_click": true, // был ли клик в письме подтверждение подписки?
"user_vars": { // массив пользовательских переменных
"boolean": false,
"float": 123123.5,
"date": "31536000",
"integer": 132131,
"null_value": null,
"string": "string",
"size": [41,42]
},
"tags": ["tag1","tag2"],
"categories": ["category1","category2"]
}
]
}Возможные значения статусов подписчика
Пример ответа в случае ошибки (json)
{
"status": "invalid",
"error": {
"source": ["Not found site (source_id=497671) or site blocked"],
"birthday": ["Неправильный формат date. Используйте формат: DD.MM.YYYY"],
...
}
}