From e22d3972a79d6f969b1e422d4dc03ea464850bd5 Mon Sep 17 00:00:00 2001
From: Christian Wolf <git@christianwolf.email>
Date: Sun, 12 Jul 2020 09:58:22 +0200
Subject: [PATCH] Added endpoint in API to allow mail confirmation

---
 api/openapi.yaml | 69 +++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 66 insertions(+), 3 deletions(-)

diff --git a/api/openapi.yaml b/api/openapi.yaml
index bca56a6..16569ba 100644
--- a/api/openapi.yaml
+++ b/api/openapi.yaml
@@ -1108,8 +1108,52 @@ paths:
           $ref: "#/components/responses/notAuth"
         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
@@ -1135,7 +1179,26 @@ paths:
           $ref: "#/components/responses/notAuth"
         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]