---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/concepts/auth-token.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/auth-token.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Авторизационные токены

Идентификация пользователей с помощью токенов, выдаваемых OAuth-сервером Яндекса.

OAuth-токен ― это специальный код, разрешающий доступ к данным конкретного пользователя. Для каждого пользователя (логина в Яндекс Директе, от имени которого осуществляются запросы к API) необходимо получить отдельный токен, который следует указывать при вызове методов.

Подробная информация об OAuth-авторизации и различных способах получения токена приведена в [руководстве по OAuth-авторизации](https://tech.yandex.ru/oauth/doc/dg/).


## Регистрация приложения {#register}

Зарегистрировать приложение на OAuth-сервере Яндекса достаточно один раз. При этом необходимо войти на Яндекс под логином разработчика приложения. Более подробная информация приведена в подразделе [Регистрация на OAuth-сервере](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/register.md) раздела [Регистрация приложения](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/register.md).


## Получение токена {#get-token}

Чтобы получить токен, приложение должно перенаправить пользователя на специальную страницу OAuth-сервера Яндекса — страницу запроса доступа. Пользователь авторизуется на Яндексе (под своим логином в Директе) и подтверждает доступ приложения к своим данным. OAuth-сервер Яндекса генерирует токен и передает его приложению.

Процедура получения токена подробно описана в [руководстве по OAuth-авторизации](https://tech.yandex.ru/oauth/doc/dg/).


{% note info %}

На этапе разработки приложения вы можете вручную получить отладочный токен от имени тестового пользователя. См. раздел [Отладочный токен](https://tech.yandex.ru/oauth/doc/dg/tasks/get-oauth-token-docpage/) руководства по OAuth-авторизации.

{% endnote %}

## Использование токена при вызове методов {#use-token}

Токен, полученный для пользователя, необходимо указывать в параметре `token` при каждом запросе к API Директа от имени этого пользователя.

Если указан неверный токен, возвращается сообщение об ошибке с кодом 53

- [Формат JSON](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/JSON.md)
- [Протокол SOAP](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/SOAP.md)


## Прекращение действия токена {#new-token-required}

Ситуации, в которых токен становится недействительным и требуется получить новый токен, перечислены в разделе [Отзыв токенов](https://tech.yandex.ru/oauth/doc/dg/reference/token-invalidate-docpage/) руководства по OAuth-авторизации.


{% note tip %}

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

{% endnote %}