Присоединение Пользователя к Клиенту

Метод используется для присоединения Пользователя к выбранному Клиенту. При этом Пользователь получает доступ к Панели управления Клиента данного Клиента.

POST /api/v2/vendor/account_accesses.json?api_token={api_token}&account_id={account_id}&user_id={user_id}&role=not_required[user, admin, owner]

Аргументы

Название

Тип параметров

Тип данных

Обязательный/Опциональный

Описание

tokenquerystringОбязательныйAPI токен сотрудника, выполняющего операцию (см. Просмотр и обновление информации о сотруднике в ActivePlatform. Руководство по Панели управления Оператора).
account_idqueryintegerОбязательныйУникальный идентификатор клиента, к которому необходимо присоединить пользователя.
user_idqueryintegerОбязательныйУникальный идентификатор пользователя, которого необходимо присоединить.

role

querystringОпциональныйУровень доступа пользователя:

  • Owner - пользователь с максимальными привилегиями. С Клиентом может быть связан только один пользователь с уровнем доступа Владелец. При выборе данного значения, создаваемый пользователь получит уровень доступа Владелец, a пользователь, который ранее обладал правами Владелец, получит уровень доступа Администратор;

  • Admin - пользователь с привилегиями администратора, который обладает правами управления подписками, создания других пользователей и назначения им прав;

  • User - пользователь с минимальным набором привилегий. Список доступных пользователю Услуг формируется пользователями с уровнем доступа Администратор или Владелец.

Если данных аргумент не указан в запросе, пользователь получает роль User.

Пример запроса

POST http://billing.activeplatform.com:80/api/v2/vendor/account_accesses?api_token=654321&account_id=2000532&user_id=2000188

Пример ответа

  • При успешном завершении операции метод возвращает код состояния HTTP 201 Created.

  • Если производится попытка отсоединить Пользователя с уровнем доступа Владелец, метод возвращает:

    {
  "error": "Owner can't be detached"
}

  • Если производится попытка присоединить несуществующего Пользователя, метод возвращает:

    {
  "error": "Couldn't find User with 'id'=2006106 "
}

  • Если производится попытка присоединить Пользователя к несуществующему Аккаунту, метод возвращает:

    {
  "error": "Couldn't find Account with 'id'=2000533 "
}