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

# Ассистент 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.com/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" target="_blank" rel="noreferrer"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Написать в чат</span> <!--текст на кнопке--> 
</a>

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

<details>
    <summary class="button">Написать в MAX</summary>
    <div class="container-gallery">
        <table>
            <td width="200px"><img src="https://yastatic.net/s3/doc-binary/src/support/adfox/ru/files/qr-code-ru-max.svg" style="width: 200px; display: block;"/>
            </td>
            <td style="padding-top: 30px;">
                <p><b>Отсканируйте QR-код.</b></p>
                <p>MAX — это внешний канал связи с Яндексом. Мы не контролируем, как MAX хранит ваши данные и переписку на своей стороне, и не несем за это ответственность. Пожалуйста, учитывайте это при выборе MAX для связи с поддержкой.</p>
            </td>
        </table>
    </div>
  <div class="container-gallery-mobile">
        <p>MAX — это внешний канал связи с Яндексом. Мы не контролируем, как MAX хранит ваши данные и переписку на своей стороне, и не несем за это ответственность. Пожалуйста, учитывайте это при выборе MAX для связи с поддержкой.</p>
        <a href="https://max.ru/yandex_adfox_bot" style="display: block; text-align: left; margin-left: 18px; color: #5889FF;">Перейти в MAX</a>
  </div>
</details>


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

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

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

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