ADFOX Sites Help

Ассистенты API

Статья была обновлена

28.11.2017

Ассистенты API – это пользователи, которые имеют доступ с заданными правами только к методам API ADFOX и не имеют доступа к веб-интерфейсу ADFOX.
В API ADFOX доступ к большинству методов предоставляется только администратору аккаунта. Зачастую это становится неудобно, когда с помощью программной интеграции с API работают разные люди с разными задачами.

Ассистенты API позволяют:
1. предоставлять сотрудникам доступ к API ADFOX с определенным набором прав:

  • RO — только чтение данных: получение списков (действия list, utility, info, listActiveBanners, listValues), получение отчетов (report);

  • RW — работа с объектами (добавление, редактирование, удаление): настройки аккаунта, сайтов, кампаний, баннеров. Запрещены только действия с пользователями (advertiser, assistant, webmaster);

  • RW + manage users – полный доступ к аккаунту.

2. не давать логин и пароль администратора аккаунта сотрудникам, работающим с API.

Для управления ассистентами API обратитесь в службу технической поддержки для подключения модуля "Ассистенты API".

Создание ассистента API

  1. В главном меню перейдите на вкладку Пользователи - Ассистенты API:

  2. Нажмите кнопку Добавить и укажите обязательные параметры:

    Учетная запись — должна быть уникальной. То есть, пользователя с такой учетной записью не должно существовать в системе ни среди рекламодателей, ни среди ассистентов, ни среди администраторов. Интерфейс предупредит, если такой логин уже занят.

    E-mail — адрес электронной почты, на который будет отправлено письмо, содержащее логин и ссылку для создания пароля.

    Настройки прав — укажите права доступа к методам API. Перечень доступных методов смотрите в документации API.
    RO — разрешено только чтение данных. Запрещено добавление, редактирование и удаление объектов, управление пользователями.
    RW — разрешено добавление, редактирование и удаление объектов. Запрещено управление пользователями.
    RW + manage users — разрешены все методы, в том числе управление пользователями.

Управление пользователями не дает прав ассистенту API управлять другими пользователями-ассистентами API.

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