Update: Refactored invitation token for UIv2

coscine/issues#1927

src/Project/Controllers/ProjectController.cs

@@ -653,9 +653,9 @@ namespace Coscine.Api.Project.Controllers
         }
 
         /// <summary>
-        /// Create and send an invitation to specified mail.
+        /// Create and send a project invitation to a specified mail.
         /// </summary>
-        /// <param name="sendInvitationObject">Informations for sending an invitation</param>
+        /// <param name="sendInvitationObject">Informations for sending an invitation. The invitation token is stored inside the URL under ".../?invitationtoken={token}".</param>
         /// <returns>NoContent</returns>
         [HttpPost("[controller]/invitation")]
         public IActionResult SendInvitation([FromBody] SendInvitationObject sendInvitationObject)
@@ -714,7 +714,7 @@ namespace Coscine.Api.Project.Controllers
                 {
                     ["placeholder"] = new JObject()
                     {
-                        ["confirmation_link"] = $"{_configuration.GetString("coscine/local/api/additional/url")}/SitePages/Home.aspx?token={token}"
+                        ["confirmation_link"] = $"{_configuration.GetString("coscine/local/api/additional/url")}/?invitationtoken={token}"
                     }
                 }
             };
@@ -725,9 +725,9 @@ namespace Coscine.Api.Project.Controllers
         }
 
         /// <summary>
-        /// Deletes an invitation.
+        /// Deletes a project invitation.
         /// </summary>
-        /// <param name="invitationId">Id of a invitation</param>
+        /// <param name="invitationId">Id of an invitation</param>
         /// <returns>NoContent</returns>
         [HttpDelete("[controller]/invitation/{invitationId}")]
         public IActionResult DeleteInvitation(Guid invitationId)
@@ -752,16 +752,16 @@ namespace Coscine.Api.Project.Controllers
         }
 
         /// <summary>
-        /// Resolve an invitation for the current user.
+        /// Resolve a project invitation for the current user.
         /// </summary>
-        /// <param name="token">Token of a invitation</param>
+        /// <param name="invitationToken">Token for a project invitation stored inside the URL under ".../?invitationtoken={token}"</param>
         /// <returns>NoContent</returns>
-        [HttpGet("[controller]/invitation/resolve/{token}")]
-        public IActionResult ResolveInvitation(Guid token)
+        [HttpGet("[controller]/invitation/resolve/{invitationtoken}")]
+        public IActionResult ResolveInvitation(Guid invitationToken)
         {
             var user = _authenticator.GetUser();
 
-            var invitation = _invitationModel.GetByToken(token);
+            var invitation = _invitationModel.GetByToken(invitationToken);
 
             if (invitation == null)
             {