---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.com/dev/adfox/doc/en/v.1/authorization.md
  - https://yandex.com/dev/adfox/doc/ru/v.1/authorization.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/ru/llms.txt

# Авторизация

Авторизация происходит при каждом запросе: нужно передавать [OAuth-токен](#token), сгенерированный для аккаунта на Яндексе, для каждого метода в HTTP-заголовке `Authorization`.
 
```xml
GET api/v1 HTTP/1.1
Host: adfox.yandex.ru
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
```
 
Если метод API вызван без токена или в запросе передан недействительный токен, сервер возвращает HTTP-статус `401 Unauthorized`.

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

Чтобы получить токен:

1. Перейдите на страницу [Создание приложения](https://oauth.yandex.ru/client/new).

2. Заполните поля:

    - **Название вашего сервиса**;

    - **Иконка сервиса** — опционально;

    - **Платформы приложения** — добавьте одну или несколько платформ;

    - **Redirect URL** — укажите `https://oauth.yandex.ru/verification_code`;

    - **Доступ к данным** — укажите `adfox:api`;

    - **Почта для связи** — опционально.
    
3. Нажмите **Создать приложение** и скопируйте его ClientID ![](_images/copy-app.png).

4. Добавьте скопированный ClientID в ссылку вида [https://oauth.yandex.ru/authorize?response_type=token&client_id=<ID приложения>](https://oauth.yandex.ru/authorize?response_type=token&client_id=).

5. Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.