API документация · /yandex/id · 26 документов

Яндекс ID OAuth: OAuth и веб-интеграция Яндекс ID

Официальная документация OAuth и веб-интеграции Яндекс ID. Найдите параметры запроса прав, обмена кода и обновления токена, проверьте тип приложения, ограничения и ошибки. Каждый результат ведёт к первоисточнику.

Паспорт источника

Service ID
/yandex/id
Источник
yandex.ru — официальная документация
Документов
26
Состав
26 страниц · 5 HTTP-операций · OAuth и веб-интеграция
Проверка источника
03.11.2026
Версия API
не подтверждена
yandex.ru/dev/id/doc/ru/

Что включено

26 документов Яндекс ID OAuth в одном поиске

Сохранённые копии yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

  • Регистрация и подключение

    8

    Обзор, советы, требования, верификация сервиса, подключение и регистрация двух типов приложений.

    • Приложение для авторизации
    • Приложение для доступа к API
  • OAuth и веб-интеграция

    11

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

    • scope, optional_scope и PKCE
    • Код устройства и GET /info
  • Жизненный цикл токенов

    7

    Реализация OAuth, JWT, отладочный токен, обновление и отзыв, глоссарий и обратная связь. Мобильные LoginSDK и архивы не входят в этот источник.

    • refresh_token и expires_in
    • Отзыв доступа и токенов устройств

С чего начать

С чего начать подключение OAuth

Условия зависят от типа приложения и прав конкретного API.

  1. Выберите тип приложенияДля входа пользователей зарегистрируйте приложение для авторизации. Приложение для доступа к API предназначено для данных разработчика. Изменить тип после регистрации нельзя.
  2. Проверьте права и callbackСверьте группы разрешений и Redirect URI. У приложения для доступа к API redirect_uri изменить нельзя; документация указывает страницу verification_code.
  3. Запросите код и обменяйте егоНастройте GET /authorize, необходимые scope и дополнительные optional_scope. Для обмена используйте POST /token с authorization_code; проверьте state и параметры PKCE.
  4. Обрабатывайте срок жизни и ошибкиСрок зависит от прав. Обновление через refresh_token не гарантирует смену access-токена. Сверяйте причины invalid_grant в контексте конкретной операции.

Типы приложений

Для авторизации
До 3 групп прав
Для доступа к API
Без группы login
Версия API
Не заявлена

Группа — часть имени права перед двоеточием. Старые приложения продолжают работать в прежнем режиме. Правила не подтверждают одобрение конкретного scope.

yandex.ru/dev/id/doc/ru/register-client

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

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу yandex.ru.

Как использовать

Три способа работать с документацией Яндекс ID OAuth

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

  1. 01 · На сайте

    Поиск без регистрации

    Выберите Яндекс ID OAuth в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.

    Яндекс ID OAuth · 26 → optional_scope
  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Найди Яндекс ID OAuth. Чем scope отличается от optional_scope, как работает force_confirm и как обновить токен? Прочитай страницы целиком и приведи официальные ссылки.»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → Получение кода подтверждения из URL

Пример ответа · GET /authorize: запрос прав

Яндекс ID OAuth /yandex/id

GET /authorize: запрос прав

Необходимые права задаются в scope, дополнительные — в optional_scope. Если право указано в обоих параметрах, оно считается опциональным. Страница также описывает обмен кода и ошибки.

Параметры

scopeString
Необходимые права из зарегистрированного набора.
optional_scopeString
Дополнительные права, выбираемые пользователем.
force_confirmyes / true / 1
Повторно запросить подтверждение прав.
yandex.ru/dev/id/doc/ru/codes/code-url

Официальный источник · версия unverifiedверсия не подтверждена

Подключение

Подключите документацию Яндекс ID OAuth к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает Яндекс ID OAuth и ещё 22 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

  1. Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
  2. Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
  3. Спросите про Яндекс ID OAuthНайди Яндекс ID OAuth и объясни получение, обновление и отзыв токенов со ссылками на первоисточник.
Только документация

Bridge8 предоставляет документацию. Регистрация приложений, выдача, обновление и отзыв токенов выполняются в сервисах Яндекса.

Claude Code — команда
claude mcp add --transport http bridge8 \ https://bridge8.ru/mcp \ --header "Authorization: Bearer <TOKEN>"
JSON для --mcp-config
{ "mcpServers": { "bridge8": { "type": "http", "url": "https://bridge8.ru/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }

Инструменты сервера — в порядке вызова

  1. resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
  2. search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
  3. get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о Яндекс ID OAuth

Что входит в источник?

Все 26 страниц OAuth и веб-интеграции из проверенного оглавления Яндекс ID. 32 страницы мобильных LoginSDK и их архивов исключены: они требуют отдельного учёта версий. Версия OAuth API не заявлена и отмечена как unverified.

Сколько групп разрешений можно запросить?

Для приложения авторизации описан предел в три группы; группа — часть имени права до двоеточия. Приложение для доступа к API не ограничено числом доступов, но не поддерживает login. Старые приложения работают в прежнем режиме; условия конкретного приложения нужно проверять отдельно.

Все ли токены действуют шесть месяцев?

Нет. Общая документация связывает срок с правами и различает продлеваемые и ограниченные токены. Шесть месяцев указаны в отдельной инструкции API фидов merchants:feeds; это не универсальное правило Яндекс ID.

Гарантирует ли refresh_token новый access-токен?

Нет. Основной токен при обновлении может остаться прежним. Документация не обещает успешное обновление после истечения срока; неверный, просроченный или принадлежащий другому приложению refresh-токен вызывает invalid_grant.

Как отозвать обычный OAuth-токен?

Пользователь может отозвать доступ приложения в Яндекс ID; соответствующий refresh-токен также отзывается. POST /revoke_token предназначен для токенов устройств. Удаление токена из локального хранилища не отзывает его у Яндекса.

Где описана ошибка access_denied?

При проверке 3 ноября 2026 года access_denied не найден в официальной странице обмена кода и полном Markdown-сборнике Яндекс ID. Это пробел первоисточника: Bridge8 не добавляет описание из общего стандарта OAuth в официальный текст. invalid_grant и другие опубликованные ошибки сохранены в контексте операций.

Ещё в Bridge8

Один поиск и один MCP-сервер для 23 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.