---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.4
alternate:
  - https://yandex.ru/dev/audience/en/intro/authorization.md
  - https://yandex.ru/dev/audience/ru/intro/authorization.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/audience/ru/llms.txt

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

Для использования API Яндекс Аудиторий необходимо получить [авторизационный токен](https://yandex.ru/dev/oauth/doc/dg/concepts/ya-oauth-intro.html) с помощью Яндекс OAuth. Токен необходимо передавать для каждого метода в HTTP-заголовке `Authorization`.

Пример в HTTP-заголовке:

```httpget translate=no
GET /v1/management/segments HTTP/1.1
Host: https://api-audience.yandex.ru
Authorization: OAuth 05dd3dd84ff948fdae2bc4fb91f13e22bb1f289ceef0037
Content-Type: application/json
Content-Length: 123
```

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

Чтобы получить авторизационный токен, [зарегистрируйте ваше приложение](https://oauth.yandex.ru/client/new). При регистрации выберите права доступа:

- создание сегментов, изменение параметров настройки своих и доверенных сегментов;
- чтение параметров настройки своих и доверенных сегментов.

Подробнее об авторизации читайте в документе [OAuth-авторизация. Руководство разработчика](https://yandex.ru/dev/oauth/doc/dg/concepts/about.html). Документ также содержит рекомендации для разработчиков клиентских приложений.

Процедура получения токена для разработки и отладки приложения описана в разделе [Отладочный токен](https://yandex.ru/dev/oauth/doc/dg/tasks/get-oauth-token.html).