Simple HTTP Auth designed

2025-10-13 17:21:28 +03:00
parent 3e2c3bf9f3
commit 6e587e8aa7
9 changed files with 414 additions and 37 deletions
--- a/specs/005-simple-http-auth/contracts/openapi.yaml
+++ b/specs/005-simple-http-auth/contracts/openapi.yaml
@@ -0,0 +1,44 @@
+openapi: 3.0.0
+info:
+  title: Simple HTTP Auth API
+  version: 1.0.0
+paths:
+  /api/auth/passphrase:
+    post:
+      summary: Authenticate with a passphrase
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                passphrase:
+                  type: string
+                  description: The passphrase to authenticate with.
+              required:
+                - passphrase
+      responses:
+        '200':
+          description: Authentication successful
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: "Authentication successful"
+                  sessionToken:
+                    type: string
+                    description: A token to maintain the session.
+        '401':
+          description: Invalid passphrase
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                    example: "Invalid passphrase"