Sharing

The sharing requests allows not only share the application with other users. Due to them you can literally manage accesses to the application. Each user can have one of the permissions to access the application.

The sharing request allows the user to share the app, assign access permission and invite people to GudHub:

1. sharing/add
2. sharing/get-app-users
3. sharing/update
4. sharing/delete
5. invitation/add

sharing/add

Due to this request, you can expand an application with other users. It contains token, user ID, application ID, and a number of sharing permission.

Request

It contains token, user ID, application ID, and a number of sharing permission.

Example:

        app_id: 178
        sharing_permission: 0
        token: bbcvqhzgr.swms-_-.oj_vdia_bert.gkanyfww_cg
        user_id: 28

Response

In response will be data about user and his permission.

{
        "user_id":28,
        "app_id":178,
        "permission":0
}

Status Code

sharing/get-app-users

The current request is called to get the list of users who has permission to the application. It is automatically called when the user clicks Sharing.

Request

This request send the token and ID of the application.

Example:

app_id: 28877
token: thog-tayjf-.k-cbeapsebnqawkphhiny-ursyqsn

Response

It returns an array of all users that have access rights to this application.

[{
        "app_id": 28877,
        "avatar_128": "https://gudhub.com/avatars/123.jpg",
        "avatar_512": "https://gudhub.com/avatars/345.jpg",
        "fullname": "John Dow",
        "sharing_permission": 2,
        "user_id": 1578
}]

Status Code

sharing/update

This is the request that allows to update the user permission.

Request

This request contains all the same token, user ID, application ID, and a number of the new user permission.

Example:

        app_id: 28753
        sharing_permission: 3
        token: lrxvzikg-mij-_szdgipxtjeybd.-v._amkdbdsxjk
        user_id: 1571

Response

In response will be updated data about user and his new permission.

{
        "user_id":1571,
        "app_id":28753,
        "permission":3
}

Status Code

sharing/delete

The current request is invoked when the owner or administrator of an application deletes a user from that application. It is not the same as the blocked permission that. The deleted user can open that app if it is public. If permission is Blocked, the blocked user will not be able to open this application anyway.

Request

The request sends the token, the ID of the user to be deleted, and the ID of the application from which the user will be deleted.

Example:

app_id: 22208
token: bgikl-szbeaqivhj.fdqu/trwbwqbgh..ffjqwb
user_id: 1534

Response

The response will be a remote user object.

{
        "app_id": 22208,
        "permission": 1,
        "user_id": 1534
}

Status Code

invitation/add

This is the request that is sent to invite the user to the GudHub. With this invitation, the user sends access to some selected applications. The user sending invitations can give any permission of the shared application to the invitee.

Request

The current request sends an array with invitees emails, an array of app objects, and token.

Example:

guests_emails: ["john@dow.com","johana@dow.com"]
apps: [{"app_id":27781,"permission":1},{"app_id":31080,"permission":2}]
token: jezyusdfmbzvqn-un._fk.ydnvamdoph.ybbdameo

Response

In response, we will get an array with objects containing the email to which the invitation will be sent, the application ID and the permission given to the invitee.

[{
        "guest_email": "john@dow.com", 
        "app_id": 27781, 
        "permission": 1
},{
        "guest_email": "johana@dow.com", 
        "app_id": 27781, 
        "permission": 1
},{
        "guest_email": "john@dow.com", 
        "app_id": 31080, 
        "permission": 2
},{
        "guest_email": "johana@dow.com",
        "app_id": 31080, 
        "permission": 2
}]

Status Code

Description of sharing_permission Value