Managing Users In Groups

This chapter describes each of the requests related to a user who belongs to a group. They all have a certain logic of operation and a few important rules.

Each of users in the group has his/her own permission.

Each of the groups uses these requests to work with users:

• sharing-group/add-user-to-group
• sharing-group/get-users-by-group
• sharing-group/update-user-in-group
• sharing-group/delete-user-from-group
• sharing-group/get-groups-by-user

Users Rules

There are two important rules for users:

• Group Owner/Admin can add User to group and set his/her permission.
• User can delete himself from group. In other words, user can leave the group.

User Permissions

sharing-group/add-user-to-group

This request allows to add a new user to the group.

Request

This request sent token, user and group IDs, and user permission to the group.

Example Request:

    token: gvydsjtynywadogvejv_bawqlztqfjabdyuhrsnref 
    group_id: 3
    user_id: 23456
    group_permission: 2

Response

In response, you will get the ID of the added user and his/her permission to the group.

{
    "user_id": 74872,
    "group_permission": 2,
    "group_id": 3
}

Status Code

sharing-group/get-users-by-group

This chapter describes each of the queries related to a user who belongs to a group. get a list of users who belong to group.

Each of users in the group has his/her own permission. to a certain group.

Request

It only accepts the token and the group ID.

Example Request:

    token: gvydsjtynywadogvejv_bawqlztqfjabdyuhrsnref
    group_id: 5

Response

The current response request returns an array of user objects. Each of them contains the group ID, the user ID, and his/her rights for that group.

[{
    "user_id": 24381,
    "group_permission": 4,
    "group_id": 5
},{
    "user_id": 24382,
    "group_permission": 1,
    "group_id": 5
},{
    "user_id": 24383,
    "group_permission": 1,
    "group_id": 5
},{
    "user_id": 24384,
    "group_permission": 0,
    "group_id": 5
}]

Status Code

sharing-group/update-user-in-group

The current request is called to change the user permission to the group.

Request

The request contains group and user IDs, and a new permission.

Example Request:

    token: gvydsjtynywadogvejv_bawqlztqfjabdyuhrsnref
    group_id: 4
    user_id: 32424
    group_permission: 0

Response

It returns the ID of the group and the user, and, accordingly, the new permission of the user in the group.

{
    "group_id": 4,
    "user_id": 23456,
    "group_permission": 0
}

Status Code

sharing-group/delete-user-from-group

To delete other users and leave the group, the user deletion request is used.

Request

This request sends the token, group and user IDs.

Example Request:

    token: gvydsjtynywadogvejv_bawqlztqfjabdyuhrsnref
    group_id: 6
    user_id: 52738

Response

In response, you will get the data about deleted user: ID of the group, his/her user ID and permission.

{
    "user_id": 34453,
    "group_permission": 2,
    "group_id": 6
}

Status Code

sharing-group/get-groups-by-user

This request allows to get the full list of the groups the certain user belongs to.

Request

It contains only the token and user ID.

Example Request:

    token: gvydsjtynywadogvejv_bawqlztqfjabdyuhrsnref
    user_id: 15432

Response

In response, you get an array of groups objects to which the user belongs.

[{
    "group_id": 1,
    "group_name": "Management",
    "user_id": 15432,
    "group_permission": 1
},{
    "group_id": 2,
    "group_name": "Developing",
    "user_id": 15432,
    "group_permission": 0
},{
    "group_id": 3,
    "group_name": "Sales",
    "user_id": 15432,
    "group_permission": 3
}]

Status Code