Checks if an invitation given by the uuid exists and if it is in a pending state. If yes return the invitation, otherwise throws an exception.
Parameter name | Data type | Description |
---|---|---|
sess | session | |
uuid | random | token assigned to the invitation |
group | the | id of the group for which the invitation is to be used |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | status is other than pending |
InvitationNotExistsException | invitation does not exist |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient rights |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/canInvitationBeAccepted
Example params
{ "sess" : {...} , "uuid" : {...} , "group" : {...} }
Example response
null
Extend the invitation date on the expiration to some later date.
Parameter name | Data type | Description |
---|---|---|
invitation | int | Invitation id |
expiration | String | New expiration date of the invitation, should be later than the old, yyyy-mm-dd format. |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | when invitation is not PENDING |
InvitationNotExistsException | Invitation does not exist |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/extendInvitationExpiration
Example params
{ "invitation" : 13 , "expiration" : "text" }
Example response
null
Extend the invitation date on the expiration by one month.
Parameter name | Data type | Description |
---|---|---|
invitation | int | Invitation id |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | when invitation is not PENDING |
InvitationNotExistsException | Invitation does not exist |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/extendInvitationExpiration
Example params
{ "invitation" : 61 }
Example response
null
Extend the invitation date on the expiration to some later date.
Parameter name | Data type | Description |
---|---|---|
uuid | token | of the Invitation |
expiration | String | New expiration date of the invitation, should be later than the old, yyyy-mm-dd format. |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | when invitation is not PENDING |
InvitationNotExistsException | Invitation does not exist |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/extendInvitationExpirationByUUID
Example params
{ "uuid" : {...} , "expiration" : "text" }
Example response
null
Extend the invitation date on the expiration by one month.
Parameter name | Data type | Description |
---|---|---|
uuid | token | of the Invitation |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | when invitation is not PENDING |
InvitationNotExistsException | Invitation does not exist |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/extendInvitationExpirationByUUID
Example params
{ "uuid" : {...} }
Example response
null
Get invitation object associated with the application. Return null if such invitation doesn't exist.
Parameter name | Data type | Description |
---|---|---|
appId | int | id of application to send notification for |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient rights |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/getInvitationByApplication
Example params
{ "appId" : 66 }
Example response
null
Returns invitation by ID
Parameter name | Data type | Description |
---|---|---|
sess | session | |
invitation | id | of the invitation |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvitationNotExistsException | invitation does not exist |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient rights |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/getInvitationById
Example params
{ "sess" : {...} , "invitation" : {...} }
Example response
null
Get page of invitations for the given group. Query parameter specifies offset, page size, sorting order, sorting column, statuses of the invitations, searched range of expiration date and string to search invitations by id, receiver name/email or sender name/email.
Parameter name | Data type | Description |
---|---|---|
group | int | Group id |
query | InvitationsPageQuery | Query with page information |
Thrown exception | Description |
---|---|
GroupNotExistsException | if there is no such group |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | if user doesn't have sufficient privileges |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
Paginated<InvitationWithSender> | page of requested invitations with sender's information |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/getInvitationsPage
Example params
{ "group" : 3 , "query" : {...} }
Example response
{ ... TODO ... }
Send invitation link to end user's email. The link leads to the application form of the group, when filled out a pre-approved application is created and associated with the invitation. Pre-approved applications bypass the application process and always are automatically approved.
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
receiverName | String | Name of the receiving user |
receiverEmail | String | Email of the receiving user |
language | String | Language to be used in invitation, should match available locales of the instance |
expiration | String | Last date, when the expiration link is valid, yyyy-mm-dd format. |
Thrown exception | Description |
---|---|
GroupNotExistsException | Group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | VO does not exist |
Return type | Description |
---|---|
Invitation | created Invitation object |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroup
Example params
{ "vo" : 91 , "group" : 47 , "receiverName" : "text" , "receiverEmail" : "text" , "language" : "text" , "expiration" : "text" }
Example response
{ ... TODO ... }
Send invitation link to end user's email. The link leads to the application form of the group, when filled out a pre-approved application is created and associated with the invitation. Pre-approved applications bypass the application process and always are automatically approved.
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
receiverName | String | Name of the receiving user |
receiverEmail | String | Email of the receiving user |
language | String | Language to be used in invitation, should match available locales of the instance |
Thrown exception | Description |
---|---|
GroupNotExistsException | Group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | VO does not exist |
Return type | Description |
---|---|
Invitation | created Invitation object |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroup
Example params
{ "vo" : 69 , "group" : 2 , "receiverName" : "text" , "receiverEmail" : "text" , "language" : "text" }
Example response
{ ... TODO ... }
Send invitation link to end user's email. The link leads to the application form of the group, when filled out a pre-approved application is created and associated with the invitation. Pre-approved applications bypass the application process and always are automatically approved.
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
receiverName | String | Name of the receiving user |
receiverEmail | String | Email of the receiving user |
language | String | Language to be used in invitation, should match available locales of the instance |
expiration | String | Last date, when the expiration link is valid, yyyy-mm-dd format. |
redirectUrl | String | Url to redirect to after filling out the application. |
Thrown exception | Description |
---|---|
GroupNotExistsException | Group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RegistrarException | when email address format is incorrect |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | VO does not exist |
Return type | Description |
---|---|
Invitation | created Invitation object |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroup
Example params
{ "vo" : 22 , "group" : 93 , "receiverName" : "text" , "receiverEmail" : "text" , "language" : "text" , "expiration" : "text" , "redirectUrl" : "text" }
Example response
{ ... TODO ... }
Send invitation link to end user's email. The link leads to the application form of the group, when filled out a pre-approved application is created and associated with the invitation. Pre-approved applications bypass the application process and always are automatically approved.
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
receiverName | String | Name of the receiving user |
receiverEmail | String | Email of the receiving user |
language | String | Language to be used in invitation, should match available locales of the instance |
redirectUrl | String | Url to redirect to after filling out the application. |
Thrown exception | Description |
---|---|
GroupNotExistsException | Group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | Insufficient rights |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RegistrarException | when email address format is incorrect |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | VO does not exist |
Return type | Description |
---|---|
Invitation | created Invitation object |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroup
Example params
{ "vo" : 26 , "group" : 17 , "receiverName" : "text" , "receiverEmail" : "text" , "language" : "text" , "redirectUrl" : "text" }
Example response
{ ... TODO ... }
Creates invitations based on the CSV parameters, for each generates the UUID token, creates invitation link to the group application form with the token as parameter and sends it to the receiver's email. Optionally a redirect url can be passed, which the user will be redirected to after filling out the form. Should an error occur in the process, the created invitation is set to the UNSENT state.
Expected format: `receiverName;receiverEmail\n`
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
invitationData | csv | file values separated by semicolon ';'. Only [name; email] is valid format. |
language | String | Language to be used in invitation, should match available locales of the instance |
expiration | String | Last date, when the expiration link is valid, yyyy-mm-dd format. |
Thrown exception | Description |
---|---|
GroupNotExistsException | group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient rights |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | vo does not exist |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroupFromCsv
Example params
{ "vo" : 8 , "group" : 70 , "invitationData" : ["user2;mail2@mail.cz"] , "language" : "text" , "expiration" : "text" }
Example response
null
Creates invitations based on the CSV parameters, for each generates the UUID token, creates invitation link to the group application form with the token as parameter and sends it to the receiver's email. Optionally a redirect url can be passed, which the user will be redirected to after filling out the form. Should an error occur in the process, the created invitation is set to the UNSENT state.
Expected format: `receiverName;receiverEmail\n`
Parameter name | Data type | Description |
---|---|---|
vo | int | VO id |
group | int | Group id |
invitationData | csv | file values separated by semicolon ';'. Only [name; email] is valid format. |
language | String | Language to be used in invitation, should match available locales of the instance |
expiration | String | Last date, when the expiration link is valid, yyyy-mm-dd format. |
redirectUrl | String | Url to redirect to after filling out the application. |
Thrown exception | Description |
---|---|
GroupNotExistsException | group does not exist |
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient rights |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
VoNotExistsException | vo does not exist |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/inviteToGroupFromCsv
Example params
{ "vo" : 3 , "group" : 37 , "invitationData" : ["user2;mail2@mail.cz"] , "language" : "text" , "expiration" : "text" , "redirectUrl" : "text" }
Example response
null
Resends the notification for the given preapproved invitation.
Parameter name | Data type | Description |
---|---|---|
invitation | int | the id of the invitation to be resent |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
InvalidInvitationStatusException | when the invitation is not in a pending state |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
PrivilegeException | insufficient permission |
RegistrarException | when unable to send the mail |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
Return type | Description |
---|---|
void |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/resendInvitation
Example params
{ "invitation" : 17 }
Example response
null
Changes status of invitation with specified id to revoked.
Parameter name | Data type | Description |
---|---|---|
sess | session | |
id | id | of the invitation |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
s | InvalidInvitationStatusException transition is not allowed from the current invitation status |
s | InvitationNotExistsException when invitation with this id does not exist |
s | PrivilegeException insufficient rights |
Return type | Description |
---|---|
Invitation | object with updated status |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/revokeInvitationById
Example params
{ "sess" : {...} , "id" : {...} }
Example response
{ ... TODO ... }
Changes status of invitation with specified uuid to revoked.
Parameter name | Data type | Description |
---|---|---|
sess | session | |
uuid | uuid | of the invitation |
Thrown exception | Description |
---|---|
InternalErrorException | When unspecified error occur. See exception param message for explanation. |
PrivilegeException | When caller is not allowed to call this method. Result may vary based on caller identity and provided parameter values. |
RpcException | Wrong usage of API (wrong url, missing param etc.). See exception params message and type for explanation. |
s | InvalidInvitationStatusException transition is not allowed from the current invitation status |
s | InvitationNotExistsException when invitation with this uuid does not exist |
s | PrivilegeException insufficient rights |
Return type | Description |
---|---|
Invitation | object with updated status |
Example URL
https://[hostname]/krb/rpc/json/invitationsManager/revokeInvitationByUuid
Example params
{ "sess" : {...} , "uuid" : {...} }
Example response
{ ... TODO ... }