Skip to main content

Добавление лидера группы

Метод и конечная точка​

POST /groups.addLeader

Описание​

Назначает пользователя лидером приватной группы. Лидер имеет расширенные права управления группой.

Параметры​

Перечень параметров представлен в таблице.

НазваниеОбязательныйТип данныхОписание
roomIdнет*stringИдентификатор группы
roomNameнет*stringНазвание группы
userIdнет**stringИдентификатор пользователя
usernameнет**stringИмя пользователя

* Должен быть указан один из параметров: roomId или roomName.

** Должен быть указан один из параметров: userId или username.

Запрос​

curl -X 'POST' \
'https://im-<ENV>.<DEFAULT_DOMAIN>/api/v1/groups.addLeader' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-User-Id: <USER_ID>' \
-H 'x-auth-token: <AUTH_TOKEN>' \
-d '{ \
"roomId": "<ROOM_ID>",
"userId": "<USER_ID_TO_ADD>"
}'

Где:

  • <ENV> — окружение, на котором выполняется запрос;
  • <DEFAULT_DOMAIN> — домен сервера Squadus;
  • <USER_ID> — идентификатор пользователя, от имени которого выполняется запрос;
  • <AUTH_TOKEN> — токен аутентификации пользователя;
  • <ROOM_ID> — идентификатор группы;
  • <USER_ID_TO_ADD> — идентификатор пользователя для назначения лидером.

Ответ​

200 — Result of adding a leader — Лидер добавлен. Пример вывода:

{
"success": true
}