AccountsApi

All URIs are relative to https://backend.id4i.de

Method	HTTP request	Description
addUserRoles	POST /api/v1/organizations/{organizationId}/users/{username}/roles	Add role(s) to user
completeRegistration	PUT /account/registration	Complete registration
findUserByUsername	GET /api/v1/users/{username}	Find by username
findUsers	GET /api/v1/users	Find users
getAllOrganizationRoles	GET /api/v1/organizations/{organizationId}/roles	List users and their roles
getOrganizationsOfUser	GET /api/v1/user/organizations	Retrieve organizations of user
getUserRoles	GET /api/v1/organizations/{organizationId}/users/{username}/roles	Get user roles by username
getUsersOfOrganization	GET /api/v1/organizations/{organizationId}/users	Find users in organization
inviteUsers	POST /api/v1/organizations/{organizationId}/users/invite	Invite Users
listAllRoles	GET /api/v1/roles	List roles
login	POST /login
registerUser	POST /account/registration	Register user
removeUserRoles	DELETE /api/v1/organizations/{organizationId}/users/{username}/roles	Remove role(s) from user
requestPasswordReset	POST /account/password	Request password reset
verifyPasswordReset	PUT /account/password	Verify password reset
verifyUserRegistration	POST /account/verification	Verify registration

addUserRoles

addUserRoles(organizationId, username, changeRoleRequest)

Add role(s) to user

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | The namespace of the organization
String username = "username_example"; // String | username
ChangeRoleRequest changeRoleRequest = new ChangeRoleRequest(); // ChangeRoleRequest | changeRoleRequest
try {
    apiInstance.addUserRoles(organizationId, username, changeRoleRequest);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#addUserRoles");
    e.printStackTrace();
}

Parameters

Name	Type	Description
organizationId	String	The namespace of the organization
username	String	username
changeRoleRequest	ChangeRoleRequest	changeRoleRequest

Return type

null (empty response body)

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

completeRegistration

completeRegistration(completeRegistration)

Complete registration

Completing a registration e.g. for invited users. Finish registration with a username and a password.

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
CompleteUserRegistrationRequest completeRegistration = new CompleteUserRegistrationRequest(); // CompleteUserRegistrationRequest | Contains the verification token, the username and the initial password.
try {
    apiInstance.completeRegistration(completeRegistration);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#completeRegistration");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
completeRegistration	CompleteUserRegistrationRequest	Contains the verification token, the username and the initial password.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

findUserByUsername

UserPresentation findUserByUsername(username)

Find by username

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String username = "username_example"; // String | username
try {
    UserPresentation result = apiInstance.findUserByUsername(username);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#findUserByUsername");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
username	String	username

Return type

UserPresentation

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

findUsers

PaginatedResponseOfUserPresentation findUsers(usernamePrefix, offset, limit)

Find users

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String usernamePrefix = "usernamePrefix_example"; // String | 
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfUserPresentation result = apiInstance.findUsers(usernamePrefix, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#findUsers");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
usernamePrefix	String		[optional]
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfUserPresentation

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

getAllOrganizationRoles

PaginatedResponseOfUserRoles getAllOrganizationRoles(organizationId, offset, limit)

List users and their roles

Listing users and their roles in a paginated manner.

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | organizationId
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfUserRoles result = apiInstance.getAllOrganizationRoles(organizationId, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#getAllOrganizationRoles");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
organizationId	String	organizationId
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfUserRoles

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

getOrganizationsOfUser

PaginatedResponseOfOrganization getOrganizationsOfUser(role, offset, limit)

Retrieve organizations of user

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String role = "role_example"; // String | role
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfOrganization result = apiInstance.getOrganizationsOfUser(role, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#getOrganizationsOfUser");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
role	String	role	[optional]
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfOrganization

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

getUserRoles

PaginatedResponseOfstring getUserRoles(organizationId, username, offset, limit)

Get user roles by username

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | The namespace of the organization
String username = "username_example"; // String | username
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfstring result = apiInstance.getUserRoles(organizationId, username, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#getUserRoles");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
organizationId	String	The namespace of the organization
username	String	username
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfstring

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

getUsersOfOrganization

PaginatedResponseOfUserPresentation getUsersOfOrganization(organizationId, offset, limit)

Find users in organization

Finding users in the specified organization in a paginated manner.

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | organizationId
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfUserPresentation result = apiInstance.getUsersOfOrganization(organizationId, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#getUsersOfOrganization");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
organizationId	String	organizationId
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfUserPresentation

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

inviteUsers

inviteUsers(organizationId, invitationList)

Invite Users

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | The namespace of the organization where users should be invited
OrganizationUserInvitationListRequest invitationList = new OrganizationUserInvitationListRequest(); // OrganizationUserInvitationListRequest | invitationList
try {
    apiInstance.inviteUsers(organizationId, invitationList);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#inviteUsers");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
organizationId	String	The namespace of the organization where users should be invited
invitationList	OrganizationUserInvitationListRequest	invitationList

Return type

null (empty response body)

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

listAllRoles

PaginatedResponseOfRole listAllRoles(privilege, offset, limit)

List roles

Listing of roles.

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String privilege = "privilege_example"; // String | If specified the roles will be filtered containing that privilege.
Integer offset = 56; // Integer | Start with the n-th element
Integer limit = 56; // Integer | The maximum count of returned elements
try {
    PaginatedResponseOfRole result = apiInstance.listAllRoles(privilege, offset, limit);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#listAllRoles");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
privilege	String	If specified the roles will be filtered containing that privilege.	[optional]
offset	Integer	Start with the n-th element	[optional]
limit	Integer	The maximum count of returned elements	[optional]

Return type

PaginatedResponseOfRole

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

login

login(accountCredentials)

ID4i API Login

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
AccountCredentials accountCredentials = new AccountCredentials(); // AccountCredentials | 
try {
    apiInstance.login(accountCredentials);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#login");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
accountCredentials	AccountCredentials

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

registerUser

UserRegistrationResponse registerUser(userRegistration)

Registering a new user.

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
UserRegistrationRequest userRegistration = new UserRegistrationRequest(); // UserRegistrationRequest | The user information about the new created user.
try {
    UserRegistrationResponse result = apiInstance.registerUser(userRegistration);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#registerUser");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
userRegistration	UserRegistrationRequest	The user information about the new created user.

Return type

UserRegistrationResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

removeUserRoles

removeUserRoles(organizationId, username, changeRoleRequest)

Remove role(s) from user

Example

// Import classes:
//import de.id4i.ApiClient;
//import de.id4i.ApiException;
//import de.id4i.Configuration;
//import de.id4i.auth.*;
//import de.id4i.api.AccountsApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Authorization
ApiKeyAuth Authorization = (ApiKeyAuth) defaultClient.getAuthentication("Authorization");
Authorization.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//Authorization.setApiKeyPrefix("Token");

AccountsApi apiInstance = new AccountsApi();
String organizationId = "organizationId_example"; // String | The namespace of the organization
String username = "username_example"; // String | username
ChangeRoleRequest changeRoleRequest = new ChangeRoleRequest(); // ChangeRoleRequest | changeRoleRequest
try {
    apiInstance.removeUserRoles(organizationId, username, changeRoleRequest);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#removeUserRoles");
    e.printStackTrace();
}

Parameters

Name	Type	Description
organizationId	String	The namespace of the organization
username	String	username
changeRoleRequest	ChangeRoleRequest	changeRoleRequest

Return type

null (empty response body)

Authorization

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

requestPasswordReset

SimpleMessageResponse requestPasswordReset(resetRequest)

Request password reset

Requesting a reset for a new password.

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
PasswordResetRequest resetRequest = new PasswordResetRequest(); // PasswordResetRequest | Contains the required information to request a new password.
try {
    SimpleMessageResponse result = apiInstance.requestPasswordReset(resetRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#requestPasswordReset");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
resetRequest	PasswordResetRequest	Contains the required information to request a new password.

Return type

SimpleMessageResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

verifyPasswordReset

SimpleMessageResponse verifyPasswordReset(verificationRequest)

Verify password reset

Setting a new password and verifying the request to set the password.

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
PasswordResetVerificationRequest verificationRequest = new PasswordResetVerificationRequest(); // PasswordResetVerificationRequest | Contains the new password and the verification token to set the new password.
try {
    SimpleMessageResponse result = apiInstance.verifyPasswordReset(verificationRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#verifyPasswordReset");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
verificationRequest	PasswordResetVerificationRequest	Contains the new password and the verification token to set the new password.

Return type

SimpleMessageResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

verifyUserRegistration

verifyUserRegistration(token)

Verify registration

Verifies a new user registration.

Example

// Import classes:
//import de.id4i.ApiException;
//import de.id4i.api.AccountsApi;


AccountsApi apiInstance = new AccountsApi();
RegistrationVerificationTokenPresentation token = new RegistrationVerificationTokenPresentation(); // RegistrationVerificationTokenPresentation | The token for user verification.
try {
    apiInstance.verifyUserRegistration(token);
} catch (ApiException e) {
    System.err.println("Exception when calling AccountsApi#verifyUserRegistration");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
token	RegistrationVerificationTokenPresentation	The token for user verification.

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

Content-Type: application/xml, application/json
Accept: application/xml, application/json

FilesExpand file tree

AccountsApi.md

Latest commit

History

AccountsApi.md

File metadata and controls

AccountsApi

addUserRoles

Example

Parameters

Return type

Authorization

HTTP request headers

completeRegistration

Example

Parameters

Return type

Authorization

HTTP request headers

findUserByUsername

Example

Parameters

Return type

Authorization

HTTP request headers

findUsers

Example

Parameters

Return type

Authorization

HTTP request headers

getAllOrganizationRoles

Example

Parameters

Return type

Authorization

HTTP request headers

getOrganizationsOfUser

Example

Parameters

Return type

Authorization

HTTP request headers

getUserRoles

Example

Parameters

Return type

Authorization

HTTP request headers

getUsersOfOrganization

Example

Parameters

Return type

Authorization

HTTP request headers

inviteUsers

Example

Parameters

Return type

Authorization

HTTP request headers

listAllRoles

Example

Parameters

Return type

Authorization

HTTP request headers

login

Example

Parameters

Return type

Authorization

HTTP request headers

registerUser

Example

Parameters

Return type

Authorization

HTTP request headers

removeUserRoles