「📝」 doc(auth): should be complete

doc/auth/2fa.md

@@ -0,0 +1,68 @@
+# 2fa
+
+Abailable endpoints:
+- POST `/2fa`
+- POST `/2fa/verify`
+- DELETE `/2fa`
+
+Common return:
+- 500 with response 
+```json
+{
+    "error": "Internal server error"
+}
+```
+
+## POST `/2fa`
+
+Used to enable 2fa (need to verify after to confirm)
+
+Inputs: just need a valid JWT cookie
+
+Returns:
+- 200
+```json
+{
+    "secret": "<the generated secret>"
+    "otpauthUrl": "<the generated url>"
+}
+```
+
+## POST `/2fa/verify`
+
+Used to confirm 2fa
+
+Inputs: a valid JWT in cookie and
+```json
+{
+    "token": "<token given by 2fa>"
+}
+```
+
+Returns: 
+- 200
+```json
+{
+    "msg": "2FA verified successfully"
+}
+```
+- 401 || 400 || 404
+```json
+{
+    "error": "<corresponding error>"
+}
+```
+
+## DELETE `/2fa`
+
+Used to remove 2fa
+
+Inputs: a valid JWT in cookie
+
+Returns: 
+- 200
+```json
+{
+    "msg": "TOTP removed"
+}
+```

doc/auth/login.md

@@ -1,6 +1,65 @@
 # Login
 
 Abailable endpoints:
-- `/login`
-- `/login/google`
-- `/login/google/callback`
+- POST `/login`
+- GET `/login/google`
+- GET `/login/google/callback`
+
+Common return:
+- 500 with response 
+```json
+{
+    "error": "Internal server error"
+}
+```
+
+## POST `/login`
+
+Used to login
+
+Input needed :
+```json
+{
+    "user": "<string>",
+    "password": "<string>"
+}
+```
+
+Can return: 
+- 200 with response and cookie in header
+```json
+{
+    "msg": "Login successfully"
+}
+```
+- 400 with response
+```json
+{
+    "error": "<corresponding error>"
+}
+```
+
+## GET `/login/google`
+
+Used to redirect the user to the login page for google auth
+
+Always return:
+- redirect to the google auth url
+
+## GET `/login/google/callback`
+
+Used to get the callback from google and confirm the login
+
+Can return:
+- 400 with response
+```json
+{
+    "error": "<corresponding error>"
+}
+```
+- 200 with response and cookie in header
+```json
+{
+    "msg": "Login successfully"
+}
+```

doc/auth/me.md

@@ -0,0 +1,5 @@
+GET `/me`
+
+Inputs : just need the JWT cookie
+
+Returns the user of the account

doc/auth/register.md

@@ -1,9 +1,9 @@
 # Register
 
 Available endpoints:
-- `/register`
-- `/register/google`
-- `/register/google/callback`
+- POST `/register`
+- GET `/register/google`
+- GET `/register/google/callback`
 
 Common return:
 - 500 with response 
@@ -13,7 +13,9 @@ Common return:
 }
 ```
 
-## `/register`
+## POST `/register`
+
+Used to register
 
 Input needed :
 ```json
@@ -37,16 +39,27 @@ Can return:
 }
 ```
 
-## `/register/google`
+## GET `/register/google`
 
-Does not take input
+Used to redirect to the google auth page
 
 Always return:
 - redirect to the google auth url
 
-## `/register/google/callback`
+## GET `/register/google/callback`
 
-inputs are filled by google
+Used to get the callback from google and register
 
 Can return:
 - 400 with response
+```json
+{
+    "error": "<corresponding error>"
+}
+```
+- 200 with response and cookie in header
+```json
+{
+    "msg": "Register successfully"
+}
+```