Added endpoint in API to allow mail confirmation

api/openapi.yaml

@@ -1109,7 +1109,51 @@ paths:
         400:
           $ref: "#/components/responses/error"
   
-  /change_password:
+  /confirm_mail/{alias}/{token}:
+    get:
+      tags: [Benutzer]
+      summary: Eine Mail eines Benutzers bestätigen
+      parameters:
+        - name: alias
+          in: path
+          required: true
+          schema:
+            type: integer
+            example: 12
+            description: Die ID des Benutzers, der die Mail hinzugefügt werden soll
+        - name: token
+          in: path
+          required: true
+          schema:
+            type: string
+            example: "asdfkhjg7854-hjkhjf-234"
+            description: Der Token, der per Mail verschickt wurde, um die Mail zu bestätigen.
+      responses:
+        200:
+          $ref: "#/components/responses/ok"
+      security: []
+  
+  /me/resend-token:
+    post:
+      tags: [Benutzer]
+      summary: Die Mail mit dem Token zur Bestätigung erneut an die Mailadresse schicken
+      parameters:
+        - name: mail
+          in: query
+          required: true
+          schema:
+            type: string
+            example: "foo@example.com"
+            description: Die Mail, die bestätigt werden soll.
+      responses:
+        200:
+          $ref: "#/components/responses/ok"
+        401:
+          $ref: "#/components/responses/notAuth"
+        400:
+          $ref: "#/components/responses/error"
+  
+  /change-password:
     post:
       tags: [Benutzer]
       summary: Das Passwort eines Nutzers anpassen
@@ -1136,6 +1180,25 @@ paths:
         400:
           $ref: "#/components/responses/error"
   
+  /reset-password:
+    get:
+      tags: [Benutzer]
+      summary: Das Passwort eines Nutzers zurücksetzen
+      parameters:
+        - name: mail
+          required: true
+          in: query
+          schema:
+            type: string
+            description: Die Mail des Nutzers, dessen Passwort zurück gesetzt werden soll
+            example: "foo@example.com"
+      responses:
+        200:
+          $ref: "#/components/responses/ok"
+        400:
+          $ref: "#/components/responses/error"
+      security: []
+  
   /users/search:
     get:
       tags: [Benutzer]