Получить OAuth-токен

Внимание. Сервис Яндекс Почта для домена больше не поддерживается. API Почты для домена прекратит работу с 1 апреля 2023 года. С 24 марта доступность сервиса будет ограничена.

Для управления доменами, пользователями и организациями используйте сервис Яндекс 360 для бизнеса.

Документация API 360

Запрос позволяет получить OAuth-токен для авторизации пользователя в Яндексе. Токен действует 30 секунд.

Примечание. Пользоваться данным запросом может только администратор.

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

Запрос следует отправлять по протоколу HTTPS с помощью метода POST.

POST /api2/admin/email/get_oauth_token
Host: pddimp.yandex.ru
PddToken: <ПДД-токен>
...

domain=<имя домена>
&(login=<email-адрес или логин почтового ящика>|uid=<идентификатор почтового ящика>)

Заголовки:


Название	Описание
PddToken	ПДД-токен.

Параметры:


Параметр	Тип	Значение
Обязательные
domain	Строка	Имя домена.
login	Строка	Email-адрес почтового ящика в формате «login@domain.ru» или «login». В запросе нужно передать только один из параметров: `login` или `uid`.
uid	Число	Идентификатор почтового ящика. Значение идентификатора можно получить в ответе на запрос Получить список почтовых ящиков. В запросе нужно передать только один из параметров: `login` или `uid`.


Параметр	Тип	Значение
Обязательные
domain	Строка	Имя домена.
login	Строка	Email-адрес почтового ящика в формате «login@domain.ru» или «login». В запросе нужно передать только один из параметров: `login` или `uid`.
uid	Число	Идентификатор почтового ящика. Значение идентификатора можно получить в ответе на запрос Получить список почтовых ящиков. В запросе нужно передать только один из параметров: `login` или `uid`.

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

POST /api2/admin/email/get_oauth_token HTTP/1.1
Host: pddimp.yandex.ru
PddToken: 123456789ABCDEF0000000000000000000000000000000000000
...
domain=domain.com&uid=123456789

cURL

curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -d 'domain=domain.com&uid=123456789' 'https://pddimp.yandex.ru/api2/admin/email/get_oauth_token'

Структура ответа

{
  "domain": "{имя домена}", 
  "login": "{адрес почтового ящика}", 
  "oauth-token": "{OAuth-токен}",
  "uid": "{идентификатор почтового ящика}",
  "success": "{статус выполнения запроса}"
}

{
  "domain": "{имя домена}", 
  "success": "{статус выполнения запроса}", 
  "error": "{код ошибки}"
}


Название	Тип значения	Описание
`domain`	Строка	Имя домена.
`login`	Строка	Email-адрес почтового ящика.
`oauth-token`	Строка	OAuth-токен, который следует передать в Яндекс Паспорт для авторизации пользователя.
`uid`	Число	Идентификатор почтового ящика.
`success`	Строка	Статус выполнения запроса. Возможные значения: `ok` — запрос выполнен успешно. `error` — запрос выполнен с ошибкой.
`error`	Строка	Код ошибки. Ключ включается в ответ, если запрос выполнен с ошибкой. Возможные значения: `unknown` — произошел временный сбой или ошибка работы API (повторите запрос позже). `no_token` (`no_domain`, `no_ip` ) — не передан обязательный параметр. `bad_domain` — имя домена не указано или не соответствует RFC. `prohibited` — запрещенное имя домена. `bad_token` (`bad_login`, `bad_passwd`) — передан неверный ПДД-токен (логин, пароль). `no_auth` — не передан заголовок `PddToken`. `not_allowed` — пользователю недоступна данная операция (он не является администратором этого домена). `blocked` — домен заблокирован (например, за спам и т.п.). `occupied` — имя домена используется другим пользователем. `domain_limit_reached` — превышено допустимое количество подключенных доменов (50). `no_reply` — Яндекс Почта для домена не может установить соединение с сервером-источником для импорта.


Название	Тип значения	Описание
`domain`	Строка	Имя домена.
`login`	Строка	Email-адрес почтового ящика.
`oauth-token`	Строка	OAuth-токен, который следует передать в Яндекс Паспорт для авторизации пользователя.
`uid`	Число	Идентификатор почтового ящика.
`success`	Строка	Статус выполнения запроса. Возможные значения: `ok` — запрос выполнен успешно. `error` — запрос выполнен с ошибкой.
`error`	Строка	Код ошибки. Ключ включается в ответ, если запрос выполнен с ошибкой. Возможные значения: `unknown` — произошел временный сбой или ошибка работы API (повторите запрос позже). `no_token` (`no_domain`, `no_ip` ) — не передан обязательный параметр. `bad_domain` — имя домена не указано или не соответствует RFC. `prohibited` — запрещенное имя домена. `bad_token` (`bad_login`, `bad_passwd`) — передан неверный ПДД-токен (логин, пароль). `no_auth` — не передан заголовок `PddToken`. `not_allowed` — пользователю недоступна данная операция (он не является администратором этого домена). `blocked` — домен заблокирован (например, за спам и т.п.). `occupied` — имя домена используется другим пользователем. `domain_limit_reached` — превышено допустимое количество подключенных доменов (50). `no_reply` — Яндекс Почта для домена не может установить соединение с сервером-источником для импорта.