---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/support/adfox/en/settings/users/assistant-api.md
  - https://yandex.ru/support/adfox/ru/settings/users/assistant-api.md
  - href: ru/settings/users/assistant-api.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/adfox/ru/llms.txt

# Ассистент API

Ассистент API — это пользователь, которому доступны только методы [API Adfox](https://yandex.ru/dev/adfox/doc/ru/v.1/concepts/access#access__assistant-api-access) и не доступен интерфейс Adfox.

В API Adfox доступ к большинству методов предоставляется только администратору аккаунта. В некоторых случаях доступ к API требуется нескольким людям, которые одновременно работают над разными задачами. Использование ассистентов API позволяет не разглашать пароль администратора и выдать сотрудникам личные доступы с определенным набором прав.

{% note warning %}

Ассистент API имеет доступ **ко всему аккаунту Adfox**, а не к отдельным кампаниям, сайтам или другим объектам.

В зависимости от выбранного уровня прав пользователь получает доступ на:

- чтение всех объектов аккаунта;
- чтение и управление всеми объектами аккаунта;
- чтение и управление всеми объектами аккаунта, а также управление пользователями.

**Не рекомендуется** выдавать учетные записи ассистентов API внешним контрагентам (например, рекламодателям или агентствам), если им не требуется доступ ко всему аккаунту.

{% endnote %}


Для подключения модуля управления ассистентами API обратитесь в [службу поддержки](https://yandex.ru/support/adfox/ru/support/feedback.md).

## Создание учетной записи {#add-assistant-api}

1. В основном меню перейдите на вкладку **Пользователи** → **Ассистенты АПИ** и нажмите **+ Добавить**.

1. Откроется страница создания учетной записи. Заполните обязательные поля:
    
    <!-- source: ru/_includes/users/add-user.md -->
    - **Учетная запись**
      
      Придумайте логин. Можно использовать только латинские буквы, цифры, тире, нижнее подчеркивание и точку. Логин должен содержать от 1 до 32 символов.

      Логин должен быть уникальным в рамках системы Adfox. Если вы введете логин, который уже занят, появится предупреждение.

    - **E-Mail**
      
      Укажите электронную почту для регистрации. На эту почту будет отправлено письмо с приглашением в интерфейс Adfox. Регистрация происходит через Яндекс ID.
    <!-- endsource: ru/_includes/users/add-user.md -->
    
    Блок **Контактная информация** можно заполнить после создания учетной записи.
    
1. Укажите права доступа к методам API. Перечень доступных методов смотрите в [документации API](https://yandex.ru/dev/adfox/doc/ru/v.1/concepts/access#access__assistant-api-access):
    
    - **Только чтение (RO)** — разрешено только чтение данных: получение списков (действия `list`, `utility`, `info`, `listActiveBanners`, `listValues`), получение отчетов (`report`). Запрещено добавление, редактирование и удаление объектов, управление пользователями.

    - **Чтение и запись (RW)** — разрешено добавление, редактирование и удаление объектов (настройки аккаунта, сайтов, кампаний, баннеров). Запрещено управление пользователями (`advertiser`, `assistant`, `webmaster`).

    - **Чтение, запись и управление пользователями (RW + manage users)** — разрешены все методы, в том числе управление пользователями.

    Управление пользователями не дает ассистенту API прав управлять другими ассистентами API.
    
1. Нажмите **Добавить**.

При выключении модуля в интерфейсе скроется вкладка **Ассистенты АПИ**. Пользователи и созданные ими объекты не удалятся, но доступ к API Adfox для них приостановится.

#### Узнайте больше

- [Документация API Adfox](https://yandex.ru/dev/adfox/doc/ru/)


<!-- source: ru/_includes/feedback.md -->
## Обратиться в службу поддержки



<a href="https://yandex.ru/chat/#/user/48724607-a983-9631-79e6-aad155a88db3"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Написать в чат</span> <!--текст на кнопке--> 
</a>

<a href="ru/form"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Написать письмо</span> <!--текст на кнопке--> 
</a>



<!-- source: ru/_includes/styles/button.md -->

<!-- endsource: ru/_includes/styles/button.md -->
<!-- endsource: ru/_includes/feedback.md -->