Пользователь клиента (/user/client/)

Протестировать методы API можно на странице интерактивного обозревателя API и без написания кода
Некоторые ресурсы, описанные на странице, по умолчанию могут быть не доступны из-за типа приложения (см. Создание и авторизация приложений)

Данный ресурс предназначен для создания, удаления, а также для управления и уточнения параметров пользователя уровня клиента. Пользователь уровня клиента имеет доступ к настройкам и ресурсам конкретного клиента, а в зависимости от типа доступа (access type) имеет полный доступ (full) или доступ только для чтения (read_only) без права на какие-либо изменения в настройках.

Описание структур данных

Имя

Тип

Обяза-тельный

Описание

Имя

Тип

Обяза-тельный

Описание

client_id

integer

да

Идентификатор клиента, для которого создается пользователь

access

string

нет

Тип доступа к ресурсам. Может быть 'full' или 'read_only' (нет прав на изменения)

comment

string

нет

Комментарий (заметка)

email

string

да

e-mail пользователя

email_notify 

boolean

нет

Если параметр принимает значение ‘True’, тогда данные для доступа в систему для нового пользователя будут высланы на электронную почту:

  • в случае задания параметра email_for_notify – на почту из email_for_notify;

  • если параметр email_for_notify не задан – текущему пользователю (который создает)

email_for_notify

string

нет

Поле, необходимое для параметра email_notify – это e-mail, куда будут отправлены данные при создании нового пользователя

extra_params

string

нет

Поле для дополнительных параметров, можно приспособить для любых целей

login

string

да

Логин пользователя

name

string

да

Имя пользователя

password

string

да

Пароль пользователя

status

string

нет

Статус пользователя. Может быть: 'active' или 'blocked'

timezone

string

нет

Пользовательская тайм-зона

Ресурсы раздела “Клиент”

POST /client/{client_id}/user/client/

Добавить нового пользователя уровня "Клиент"

Параметры URL

Имя

Тип

Имя

Тип

client_id

string

Параметры запроса

Имя

Тип

Имя

Тип

access

string

comment

string

email

string

email_notify 

boolean

extra_params

string

login

string

name

string

password

string

status

string

timezone

string

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

Имя

Тип

Имя

Тип

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

GET /client/{client_id}/user/client/

Получить список пользователей уровня “Клиент”

Параметры URL

Имя

Тип

Имя

Тип

client_id

string

Параметры запроса (фильтр)

Имя

Тип

Имя

Тип

login

array [string]

id

array [integer]

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

Имя

Тип

Имя

Тип

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

PUT /client/{client_id}/user/client/{user_id}

Обновить пользователя уровня “Клиент”

Параметры URL

Имя

Тип

Имя

Тип

user_id

integer

client_id

string

Параметры запроса

Имя

Тип

Имя

Тип

comment

string

status

string

name

string

access

string

extra_params

string

timezone

string

password

string

email

string

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

Имя

Тип

Имя

Тип

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

GET /client/{client_id}/user/client/{user_id}

Запросить параметры пользователя уровня “Клиент”

Параметры URL

Имя

Тип

Имя

Тип

user_id

integer

client_id

string

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

Имя

Тип

Имя

Тип

comment

string

status

string

name

string

email

string

access

string

client_id

long

extra_params

string

timezone

string

login

string

id

long

DELETE /client/{client_id}/user/client/{user_id}

Удалить пользователя уровня “Клиент”

Параметры URL

Имя

Тип

Имя

Тип

user_id

integer

client_id

string