documentation for reset password API calls

web/src/main/asciidoc/user.adoc

@@ -118,3 +118,17 @@ include::{snippets}/user/update_user/curl-request.adoc[]
 === Path Parameters
 include::{snippets}/user/update_user/path-parameters.adoc[]
 
+== Request password reset over email 
+=== CURL sample
+include::{snippets}/user/request_reset_password/curl-request.adoc[]
+
+=== Path Parameters
+include::{snippets}/user/request_reset_password/path-parameters.adoc[]
+
+== Reset password using token obtained over email 
+=== CURL sample
+include::{snippets}/user/reset_password/curl-request.adoc[]
+
+=== Request Parameters
+include::{snippets}/user/reset_password/request-parameters.adoc[]
+

web/src/test/java/lcsb/mapviewer/web/UserControllerIntegrationTest.java

@@ -522,7 +522,7 @@ public class UserControllerIntegrationTest extends ControllerIntegrationTest {
     RequestBuilder grantRequest = post("/users/{login}:requestResetPassword", BUILT_IN_TEST_ADMIN_LOGIN);
 
     mockMvc.perform(grantRequest)
-        .andDo(document("user/reset_password",
+        .andDo(document("user/request_reset_password",
             pathParameters(parameterWithName("login").description("user login"))))
         .andExpect(status().is2xxSuccessful());
     assertEquals(count + 1, resetPasswordTokenDao.getCount());
@@ -618,6 +618,14 @@ public class UserControllerIntegrationTest extends ControllerIntegrationTest {
         .contentType(MediaType.APPLICATION_FORM_URLENCODED);
 
     mockMvc.perform(resetRequest)
+        .andDo(document("user/reset_password",
+            requestParameters(
+                parameterWithName("password")
+                    .optional()
+                    .description("new password"),
+                parameterWithName("token")
+                    .optional()
+                    .description("reset poassowrd token obtained using email"))))
         .andExpect(status().is2xxSuccessful());
 
     createSession(BUILT_IN_TEST_ADMIN_LOGIN, newPassword);