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

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

{% note info %}

Если у логина уже существует действующий токен API Adfox, используемый для управления объектами, получать дополнительный токен для доступа к статистике не нужно. Для всех разделов API используется единый токен авторизации.

{% endnote %}

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

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

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

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

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

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

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

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

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

    - **Почта для связи** — опционально.
    
3. Нажмите **Создать приложение** и скопируйте его ClientID ![](../v.1/_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. Перейдите по ссылке и на открывшейся странице скопируйте ваш авторизационный токен.

## Авторизация {#authorization}

Авторизация происходит при каждом запросе: нужно передавать OAuth-токен, сгенерированный для аккаунта на Яндексе, для каждого метода в HTTP-заголовке `Authorization`.

```
Authorization: OAuth <токен>
```

Пример

```
curl -H 'Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037' \
  https://adfox.yandex.ru/api/v2/reports/metadata
```

## Запросы от разных типов пользователей

Для администратора и ассистентов передавать в запросах параметр `ownerId` необязательно.

Для запросов от аккаунтов рекламодателя или владельца сайта при каждом запросе передавайте параметр `ownerId` — идентификатор аккаунта администратора, от имени которого строится отчет.

#|
|| **Эндпоинт** | **Тип пользователя** | **Обязательность ownerId** ||
|| `/metadata` 
`/available-dates` | Администратор / ассистент | Не обязателен. Если передан — должен совпадать с вашим `ownerId`. ||
|| `/metadata` 
`/available-dates` | Рекламодатель / владелец сайта | Обязателен. ||
|| `/{taskId}` `/{taskId}/result` | Любой | `ownerId` не принимают — задача всегда ищется среди задач текущего пользователя. ||
|#

В `GET`-запросах `ownerId` передается как query-параметр:

```text id="f9a1ls"
?ownerId=12345
```

В `POST`-запросе `ownerId` передается в теле запроса как целое положительное число.