Interface UsersApi
public interface UsersApi
-
Method Summary
Modifier and TypeMethodDescriptionretrofit2.Call<ChangePwdUsersUserIdResponse> changePassword(Long userId, ChangePwdUsersUserIdRequest changePwdUsersUserIdRequest) Change the password of a User When updating a password you must provide the repeatPassword parameter also.retrofit2.Call<ChangePwdUsersUserIdResponse> changePassword(Long userId, ChangePwdUsersUserIdRequest changePwdUsersUserIdRequest, Map<String, String> headers) Change the password of a User When updating a password you must provide the repeatPassword parameter also.retrofit2.Call<PostUsersResponse> create15(PostUsersRequest postUsersRequest) Create a User Adds new application user.retrofit2.Call<PostUsersResponse> create15(PostUsersRequest postUsersRequest, Map<String, String> headers) Create a User Adds new application user.retrofit2.Call<DeleteUsersUserIdResponse> Delete a User Removes the user and the associated roles and permissions.retrofit2.Call<DeleteUsersUserIdResponse> Delete a User Removes the user and the associated roles and permissions.retrofit2.Call<Void> getUserTemplate(Long officeId, Long staffId, String dateFormat) retrofit2.Call<Void> retrofit2.Call<String> postUsersTemplate(String dateFormat, String locale, okhttp3.MultipartBody.Part uploadedInputStream) retrofit2.Call<String> postUsersTemplate(String dateFormat, String locale, okhttp3.MultipartBody.Part uploadedInputStream, Map<String, String> headers) retrofit2.Call<List<GetUsersResponse>> Retrieve list of users Example Requests: users users?fields=id,username,email,officeNameretrofit2.Call<List<GetUsersResponse>> retrieveAll41(Map<String, String> headers) Retrieve list of users Example Requests: users users?fields=id,username,email,officeNameretrofit2.Call<GetUsersUserIdResponse> retrieveOne31(Long userId) Retrieve a User Example Requests: users/1 users/1?template=true users/1?fields=username,officeNameretrofit2.Call<GetUsersUserIdResponse> retrieveOne31(Long userId, Map<String, String> headers) Retrieve a User Example Requests: users/1 users/1?template=true users/1?fields=username,officeNameretrofit2.Call<GetUsersTemplateResponse> Retrieve User Details Template This is a convenience resource.retrofit2.Call<GetUsersTemplateResponse> template22(Map<String, String> headers) Retrieve User Details Template This is a convenience resource.retrofit2.Call<PutUsersUserIdResponse> update26(Long userId, PutUsersUserIdRequest putUsersUserIdRequest) Update a User Updates the userretrofit2.Call<PutUsersUserIdResponse> Update a User Updates the user
-
Method Details
-
changePassword
@Headers("Content-Type:application/json") @POST("v1/users/{userId}/pwd") retrofit2.Call<ChangePwdUsersUserIdResponse> changePassword(@Path("userId") Long userId, @Body ChangePwdUsersUserIdRequest changePwdUsersUserIdRequest) Change the password of a User When updating a password you must provide the repeatPassword parameter also.- Parameters:
userId- userId (required)changePwdUsersUserIdRequest- (required)- Returns:
- Call<ChangePwdUsersUserIdResponse>
-
create15
@Headers("Content-Type:application/json") @POST("v1/users") retrofit2.Call<PostUsersResponse> create15(@Body PostUsersRequest postUsersRequest) Create a User Adds new application user. Note: Password information is not required (or processed). Password details at present are auto-generated and then sent to the email account given (which is why it can take a few seconds to complete). Mandatory Fields: username, firstname, lastname, email, officeId, roles, sendPasswordToEmail Optional Fields: staffId,passwordNeverExpires,isSelfServiceUser,clients- Parameters:
postUsersRequest- (required)- Returns:
- Call<PostUsersResponse>
-
delete23
@DELETE("v1/users/{userId}") retrofit2.Call<DeleteUsersUserIdResponse> delete23(@Path("userId") Long userId) Delete a User Removes the user and the associated roles and permissions.- Parameters:
userId- userId (required)- Returns:
- Call<DeleteUsersUserIdResponse>
-
getUserTemplate
@GET("v1/users/downloadtemplate") retrofit2.Call<Void> getUserTemplate(@Query("officeId") Long officeId, @Query("staffId") Long staffId, @Query("dateFormat") String dateFormat) - Parameters:
officeId- (optional)staffId- (optional)dateFormat- (optional)- Returns:
- Call<Void>
-
postUsersTemplate
@Multipart @POST("v1/users/uploadtemplate") retrofit2.Call<String> postUsersTemplate(@Part("dateFormat") String dateFormat, @Part("locale") String locale, @Part okhttp3.MultipartBody.Part uploadedInputStream) - Parameters:
dateFormat- (optional)locale- (optional)uploadedInputStream- (optional)- Returns:
- Call<String>
-
retrieveAll41
Retrieve list of users Example Requests: users users?fields=id,username,email,officeName- Returns:
- Call<List<GetUsersResponse>>
-
retrieveOne31
@GET("v1/users/{userId}") retrofit2.Call<GetUsersUserIdResponse> retrieveOne31(@Path("userId") Long userId) Retrieve a User Example Requests: users/1 users/1?template=true users/1?fields=username,officeName- Parameters:
userId- userId (required)- Returns:
- Call<GetUsersUserIdResponse>
-
template22
Retrieve User Details Template This is a convenience resource. It can be useful when building maintenance user interface screens for client applications. The template data returned consists of any or all of: Field Defaults Allowed description Lists Example Request: users/template- Returns:
- Call<GetUsersTemplateResponse>
-
update26
@Headers("Content-Type:application/json") @PUT("v1/users/{userId}") retrofit2.Call<PutUsersUserIdResponse> update26(@Path("userId") Long userId, @Body PutUsersUserIdRequest putUsersUserIdRequest) Update a User Updates the user- Parameters:
userId- userId (required)putUsersUserIdRequest- (required)- Returns:
- Call<PutUsersUserIdResponse>
-
changePassword
@Headers("Content-Type:application/json") @POST("v1/users/{userId}/pwd") retrofit2.Call<ChangePwdUsersUserIdResponse> changePassword(@Path("userId") Long userId, @Body ChangePwdUsersUserIdRequest changePwdUsersUserIdRequest, @HeaderMap Map<String, String> headers) Change the password of a User When updating a password you must provide the repeatPassword parameter also.- Parameters:
userId- userId (required)changePwdUsersUserIdRequest- (required)- Returns:
- Call<ChangePwdUsersUserIdResponse>
-
create15
@Headers("Content-Type:application/json") @POST("v1/users") retrofit2.Call<PostUsersResponse> create15(@Body PostUsersRequest postUsersRequest, @HeaderMap Map<String, String> headers) Create a User Adds new application user. Note: Password information is not required (or processed). Password details at present are auto-generated and then sent to the email account given (which is why it can take a few seconds to complete). Mandatory Fields: username, firstname, lastname, email, officeId, roles, sendPasswordToEmail Optional Fields: staffId,passwordNeverExpires,isSelfServiceUser,clients- Parameters:
postUsersRequest- (required)- Returns:
- Call<PostUsersResponse>
-
delete23
@DELETE("v1/users/{userId}") retrofit2.Call<DeleteUsersUserIdResponse> delete23(@Path("userId") Long userId, @HeaderMap Map<String, String> headers) Delete a User Removes the user and the associated roles and permissions.- Parameters:
userId- userId (required)- Returns:
- Call<DeleteUsersUserIdResponse>
-
getUserTemplate
@GET("v1/users/downloadtemplate") retrofit2.Call<Void> getUserTemplate(@Query("officeId") Long officeId, @Query("staffId") Long staffId, @Query("dateFormat") String dateFormat, @HeaderMap Map<String, String> headers) - Parameters:
officeId- (optional)staffId- (optional)dateFormat- (optional)- Returns:
- Call<Void>
-
postUsersTemplate
@Multipart @POST("v1/users/uploadtemplate") retrofit2.Call<String> postUsersTemplate(@Part("dateFormat") String dateFormat, @Part("locale") String locale, @Part okhttp3.MultipartBody.Part uploadedInputStream, @HeaderMap Map<String, String> headers) - Parameters:
dateFormat- (optional)locale- (optional)uploadedInputStream- (optional)- Returns:
- Call<String>
-
retrieveAll41
@GET("v1/users") retrofit2.Call<List<GetUsersResponse>> retrieveAll41(@HeaderMap Map<String, String> headers) Retrieve list of users Example Requests: users users?fields=id,username,email,officeName- Returns:
- Call<List<GetUsersResponse>>
-
retrieveOne31
@GET("v1/users/{userId}") retrofit2.Call<GetUsersUserIdResponse> retrieveOne31(@Path("userId") Long userId, @HeaderMap Map<String, String> headers) Retrieve a User Example Requests: users/1 users/1?template=true users/1?fields=username,officeName- Parameters:
userId- userId (required)- Returns:
- Call<GetUsersUserIdResponse>
-
template22
@GET("v1/users/template") retrofit2.Call<GetUsersTemplateResponse> template22(@HeaderMap Map<String, String> headers) Retrieve User Details Template This is a convenience resource. It can be useful when building maintenance user interface screens for client applications. The template data returned consists of any or all of: Field Defaults Allowed description Lists Example Request: users/template- Returns:
- Call<GetUsersTemplateResponse>
-
update26
@Headers("Content-Type:application/json") @PUT("v1/users/{userId}") retrofit2.Call<PutUsersUserIdResponse> update26(@Path("userId") Long userId, @Body PutUsersUserIdRequest putUsersUserIdRequest, @HeaderMap Map<String, String> headers) Update a User Updates the user- Parameters:
userId- userId (required)putUsersUserIdRequest- (required)- Returns:
- Call<PutUsersUserIdResponse>
-