Список зарегистрированных доменов и адресов

Получить список почтовых доменов и email-адресов, заявленных пользователем в Почтовом офисе. Для каждого домена/адреса указывается этап прохождения регистрации.

Синтаксис запроса

https://postoffice.yandex.ru/api/1.0/reg-list
 ? oauth_token=<токен>
Query-параметры
oauth_token *

Токен доступа OAuth. Подробнее о процедуре получения токена см. в разделе Авторизация приложения с помощью OAuth-токена.

*  Обязательный параметр

Формат ответа

Возвращает список почтовых доменов и адресов, которые пользователь заявил в Почтовом офисе для сбора статистики рассылок. Для каждого домена/адреса указывается этап его регистрации в Почтовом офисе (не подтвержден/подтвержден/введено описание).

{
    "session":"seij3uoM",
    "list":[
      {
       "domain":"example.com",
       "status": 2
      },
      {
        "email":"noreply@company.ru",
        "status": 3
      },
      {
        "email":"someuser@somemail.com",
        "status": 1
      }
    ]   
}
session

Идентификатор сессии, в рамках которой обрабатывался запрос к API. Сообщайте этот идентификатор при обращении в службу поддержки Яндекса по поводу сбоев или ошибок в работе API Почтового офиса.

list

Список почтовых доменов и адресов, заявленных пользователем в Почтовом офисе. Значение — массив. Каждый почтовый домен или адрес представлен в виде хэша — элемента массива. Порядок следования доменов и адресов в списке не гарантируется.

domain

Почтовый домен, заявленный пользователем в Почтовом офисе в качестве источника рассылок. Значение — строка.

email

Адрес электронной почты, заявленный пользователем в Почтовом офисе в качестве источника рассылок. Значение — строка.

status

Этап регистрации почтового домена или адреса электронной почты в Почтовом офисе. Допустимые значения:

  • 1 — не подтвержден. Пользователь добавил домен или адрес в интерфейсе Почтового офиса, но не подтвердил владение им. Данные по рассылкам с этого домена или адреса не собираются.
  • 2 — подтвержден. Пользователь подтвердил владение доменом или адресом в интерфейсе Почтового офиса. Данные по рассылкам с этого домена или адреса собираются.
  • 3 — введено описание. Пользователь подтвердил владение доменом или адресом и ввел текстовое описание к нему. Данные по рассылкам с этого домена или адреса собираются.