Проверить книгу

Чтобы отправить книгу на проверку, отправляется POST запрос по ссылке:

https://api.sendpulse.com/verifier-service/send-list-to-verify/

Параметры запроса:

id идентификатор книги, которую нужно проверить

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

{
   "id":89165888
}

Обратите внимание, что запустить несколько проверок на одну и ту же книгу одновременно невозможно.. Нужно дождаться окончания первой проверки. Проверить прогресс проверки можно методом Получить прогресс проверки книги.

Если вы отправляете книгу на повторную проверку, в нее должны быть добавлены новые адреса. Проверка осуществляется только по книге, на которую не было рассылок. Также обращайте внимание на срок действия вашего текущего плана и количество доступных проверок. 

В случае успешного запроса, сервер вернет ответ:

{
    "result": true
}

Для просмотра результата проверки используйте метод Получить результат проверки книги.

 

Получить прогресс проверки книги

Чтобы получить прогресс проверки адресной книги, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/get-progress/?id={id} 

Параметры запроса:

id идентификатор книги, которая проверяется

В случае успешного запроса, сервер вернет массив со счетчиками, сколько проверено из скольки:

{
    "result": true,
    "data": {
        "total": 22,
        "processed": 22
    }
}

Получить результат проверки книги

Чтобы получить список адресов из книги с результатом проверки, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/check/?id={id} 

Параметры запроса:

id идентификатор книги, которую проверили

Обратите внимание, что методы следует использовать попарно: cначала нужно использовать метод «Проверить книгу», затем «Получить результат проверки книги». В противном случае вы получите ошибку «false».

В случае успешного запроса, сервер вернет ответ:

{
    "id": 89163337,
    "address_book_name": "Новая адресная книга",
    "all_emails_quantity": 5, //количество активных емейлов в книге
    "status": 1,
    "check_date": "2020-11-19 13:42:11",
    "data": {
        "0": 0, // количество непроверенных адресов (серые)
"1": 5, // количество действительных адресов (зеленые)
"2": 1, // количество неподтвержденных адресов (желтые)
"3": 0 // количество недействительных адресов (красные) }, "is_updated": 0, // 1 - в книгу были добавлены новые адреса после проверки, 0 - по книге не было проверки "status_text": "Зелёный", "email_addresses": [ { "id": 10417371353, "email_address": "example1@mail.ru", "check_date": "2020-11-19 13:41:20", "status": 1, "status_text": "Действительный адрес" }, { "id": 10417371352, "email_address": "example2@ukr.net", "check_date": "2020-11-19 13:41:23", "status": 1, "status_text": "Действительный адрес" }, { "id": 10417371349, "email_address": "example3@gmail.com", "check_date": "2020-11-19 13:41:20", "status": 1, "status_text": "Действительный адрес" }, { "id": 10417371347, "email_address": "example4@gmail.com", "check_date": "2020-11-19 13:41:21", "status": 1, "status_text": "Действительный адрес" }, { "id": 10417371345, "email_address": "example5@rambler.ru", "check_date": "2020-11-19 13:41:20", "status": 1, "status_text": "Действительный адрес" } ], "email_addresses_total": 5 // количество проверок в книге }

Возможные статусы адреса:

Код Описание
0 Непроверенный адрес (адрес добавился после проверки)
1 Действительный адрес
2 Неподтвержденный адрес
3 Недействительный адрес

Получить список проверенных книг

Чтобы получить список проверенных адресных книг, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/check-list

Параметры запроса:

start с какой записи выводить результат; по умолчанию 0, необязательный параметр
count количество записей, по умолчанию 10, необязательный параметр

В случае успешного запроса, сервер вернет ответ:

{
    "total": 2, // количество проверенных адресных книг
    "list": [
        {
            "id": 89114118,
            "address_book_name": "Mailing list 1",
            "all_emails_quantity": 20, //количество активных емейлов в книге
            "status": 1, // статус проверки адресной книги
            "check_date": "2020-11-23 14:28:14", // дата проверки
            "data": {
                "0": 0, // количество непроверенных адресов (серые)
                "1": 21, // количество действительных адресов (зеленые)
                "2": 1, // количество неподтвержденных адресов (желтые)
                "3": 0 // количество недействительных адресов (красные)
            },
            "is_updated": 0, // 1 - в книгу были добавлены новые адреса после проверки, 0 по книге не было проверки
            "status_text": "Зеленый",
            "is_garbage_in_book": false // true в книге есть ранее проверенные адреса, false по книге не было проверки
        },
        {
            "id": 89163340,
            "address_book_name": "Mailing list 2",
            "all_emails_quantity": 2, //количество активных емейлов в книге
            "status": 1,
            "check_date": "2020-11-19 13:43:11",
            "data": {
                "0": 0, // количество непроверенных адресов (серые)
                "1": 2, // количество действительных адресов (зеленые)
                "2": 0, // количество неподтвержденных адресов (желтые)
                "3": 0 // количество недействительных адресов (красные)
            },
            "is_updated": 1, // 1 - в книгу были добавлены новые адреса после проверки, 0 по книге не было проверки
            "status_text": "Зелёный, обновлён",
            "is_garbage_in_book": true // true в книге есть ранее проверенные адреса, false по книге не было проверки
        }
    ]
}

Возможные статусы адресных книг:

Код Название Описание
1 Зеленый может содержать небольшой процент невалидных и неподтвержденных адресов, но в целом список считается «качественным»
2 Желтый содержит небольшой процент невалидных адресов и много неподтвержденных адресов
3 Красный содержит большой процент невалидных адресов

Удалить результат проверки книги

Чтобы удалить результат проверки адресной книги, отправляется POST запрос по ссылке:

https://api.sendpulse.com/verifier-service/delete-list-result

Параметры запроса:

id идентификатор книги для которой нужно удалить результат проверки 

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

{
   "id":89165888
}

В случае успешного запроса, сервер вернет ответ:

{
    "result": true
}

Проверить адрес

Чтобы проверить один адрес, отправляется POST запрос по ссылке:

https://api.sendpulse.com/verifier-service/send-single-to-verify/

Параметры запроса:

email электронный адрес, который нужно проверить

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

{
   "email":"user@example.com"
}

В случае успешного запроса, сервер вернет ответ:

{
    "result": true
}

Для просмотра результата проверки используйте метод Получить результат проверки адреса.

 

Получить результат проверки адреса

Чтобы получить результат проверки адреса, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/get-single-result/?email={email}

Параметры запроса:

email электронный адрес, который проверяли

Обратите внимание, что методы следует использовать попарно: cначала нужно использовать метод «Проверить адрес», затем «Получить результат проверки адреса». В противном случае вы получите ошибку «false»

В случае успешного запроса, сервер вернет ответ:

{
    "result": true,
    "data": {
        "email": "example1@gmail.com",
        "checks": {
            "status": 1,
            "valid_format": 1, // 1, если формат адреса правильный, то есть содержит допустимые символы в правильном порядке
            "disposable": 0, //1, если адрес предоставлен одноразовой службой электронной почты
            "webmail": 0, //1, если адрес предоставлен службой электронной почты
            "gibberish": 0, //1, если адрес сгенерирован автоматически
            "status_text": "Действительный адрес"
        }
}

Удалить результат проверки адреса

Чтобы удалить результат проверки одного адреса, отправляется POST запрос по ссылке:

https://api.sendpulse.com/verifier-service/delete-single-result

Параметры запроса:

email электронный адрес для которого нужно удалить результат проверки

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

{
   "email":"user@example.com"
}

В случае успешного запроса, сервер вернет ответ:

{
    "result": true
}

Создать отчет проверки адресной книги

Чтобы создать отчет c результатами проверки адресной книги, отправляется POST запрос по ссылке:

https://api.sendpulse.com/verifier-service/make-report

Параметры запроса:

id идентификатор книги, которую проверяли
format формат отчета, может принимать значения 2 - csv, 3 - xls, 4 -xlsx; по умолчанию 2; необязательный параметр
status json_encoded массив, адреса с какими статусами должны быть в отчете 0 - непроверенные, 1 - действительные, 2 - неподтвержденные, 3 - недействительные; по умолчанию [1]; необязательный параметр
lang язык отчета; необязательный параметр

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

{
   "id":89165888,
   "format":2,
   "status":"[1,2,3]",
   "lang":"ru"
}

В случае успешного запроса, сервер вернет ответ:

{
 "result": true
}

Просмотреть отчет проверки книги

Чтобы просмотреть отчет c результатами проверки адресной книги, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/check-report?id={id}

Параметры запроса:

id идентификатор книги, для которой создали отчет
format формат отчета, может принимать значения 2 - csv, 3 - xls, 4 -xlsx; по умолчанию 2; необязательный параметр

Обратите внимание, что методы следует использовать последовательно: cначала нужно использовать метод «Создать отчет», затем «Получить отчет проверки» и «Cкачать отчет». В противном случае вы получите ошибку «false».

В случае успешного запроса, сервер вернет ответ:

{
    "id": 89165888,
    "address_book_name": "Новый список 1",
    "all_emails_quantity": 10, //количество активных емейлов в книге
    "status": 3,
    "check_date": "2020-11-23 18:02:36",
    "data": {
        "0": 0,
        "1": 3,
        "2": 1,
        "3": 0
    },
    "is_updated": 0, // 1 - в книгу были добавлены новые адреса после проверки, 0 по книге не было проверки
    "status_text": "Желтый",
    "email_addresses": [
        {
            "id": 10422192143,
            "email_address": "user@example.com",
            "check_date": "2020-11-23 18:01:35",
            "status": 3,
            "status_text": "Неподтвержденный адрес"
        },
        {
            "id": 10422192131,
            "email_address": "user2@example.com",
            "check_date": "2020-11-23 18:01:35",
            "status": 1,
            "status_text": "Действительный адрес"
        },
        {
            "id": 10422192128,
            "email_address": "user3@example.com",
            "check_date": "2020-11-23 18:01:34",
            "status": 1,
            "status_text": "Действительный адрес"
        },
        {
            "id": 10422192125,
            "email_address": "user4@example.com",
            "check_date": "2020-11-23 18:01:35",
            "status": 1,
            "status_text": "Действительный адрес"
        }
    ],
    "email_addresses_total": 4 // количество проверок в книге
}

Скачать отчет проверки книги

Чтобы скачать отчет c результатами проверки адресной книги, отправляется GET запрос по ссылке:

https://api.sendpulse.com/verifier-service/get-report?id={id}

Параметры запроса:

id идентификатор книги, для которой создали отчет
format формат отчета, может принимать значения 2 - csv, 3 - xls, 4 -xlsx; по умолчанию 2; необязательный параметр

В случае успешного запроса получите список адресов и статус проверки каждого в выбранном формате.

Обратите внимание, что после скачивания отчета он будет удален из базы. При повторной попытке получения отчета получите ответ false.