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

Для работы с API Мониторинга нужен OAuth-токен. Требования к OAuth-токену:

• Токен должен быть создан для пользователя, который является администратором в компании.
• Токен не должен быть отозван. Подробнее см. в разделе Время жизни токена.

Перед началом работы с API Мониторинга получите OAuth-токен:

1. При необходимости создайте аккаунт с Яндекс ID. При регистрации используйте корпоративный или любой другой электронный адрес на Яндекс Почте.

2. Авторизуйтесь на Яндексе под логином, который будет использоваться для загрузки данных.

3. Откройте страницу Доступ внешних приложений и нажмите Создать.

4. Выберите опцию Для доступа к API или отладки и нажмите Перейти к созданию.

   Для доступа к дополнительным возможностям сервиса OAuth вам может быть предложено пройти верификацию с помощью аккаунта на Госуслугах. Чтобы пропустить этот шаг, закройте окно с предложением о регистрации.

5. Заполните поле Название вашего сервиса. Название сервиса может быть любым. Оно появится в списке ваших приложений в сервисе OAuth для Яндекс ID. Иконку сервиса прикреплять не обязательно.

6. В поле Почта для связи укажите адрес электронной почты.

7. В поле Название доступа введите courier:logistician.

8. Нажмите Создать приложение.

   Откроется страница приложения. Идентификатор приложения из поля ClientID потребуется для получения OAuth-токена.

   

9. Получите OAuth-токен. Для этого:

   1. Перейдите по ссылке. Вместо <ClientID-вашего-приложения> подставьте значение из пункта 7.

      https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID-вашего-приложения>
      

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

   3. Нажмите Войти как <логин>.

   4. Скопируйте последовательность символов, появившихся на экране — это и есть ваш OAuth-токен.

   5. Убедитесь, что токен работает. Для этого добавьте его в заголовок запроса:

   curl -H "Authorization: OAuth <ваш-OAuth-токен>" -X GET https://courier.yandex.ru/api/v1/test
   

   Ответом должно быть сообщение: {"message":"OK"}.

   Дополнительную информацию об OAuth можно найти в разделе Реализация OAuth в Яндексе.

Время жизни токена

Время жизни токена не ограничено.

Токен может стать недействителен в следующих случаях:

• Он был отозван. Если ваш токен отозвали, вам нужно получить новый. О причинах отзыва см. в разделе Отзыв токенов.
• Пользователь сменил пароль учетной записи, на которую был выдан токен.
• Пользователь учетной записи, на которую был выдан токен, нажал кнопку Выйти из всех сервисов Яндекса.

Решение проблем

Ошибка unauthorized_client при получении OAuth-токена

Ошибка возникает при получении OAuth-токена (пункт 8.1), если для вашего аккаунта есть ограничения. В этом случае отправьте обращение через форму. Служба поддержки примет решение о снятии ограничений и свяжется с вами.