docs: add OpenAPI documentation

2025-08-12 17:29:02 +02:00
parent cd91ac11f9
commit aab7ff1452
25 changed files with 2422 additions and 0 deletions
--- a/openapi/paths/account-register.yaml
+++ b/openapi/paths/account-register.yaml
@@ -0,0 +1,23 @@
+post:
+  tags:
+    - Account
+  summary: "Register an account"
+  operationId: "RegisterAccount"
+  requestBody:
+    content:
+      application/json:
+        schema:
+          $ref: "../schemas/Account.yaml"
+        examples:
+          accountIn:
+            $ref: "../examples/AccountIn.yaml"
+    required: true
+  responses:
+    "200":
+      description: "OK"
+    "400":
+      description: "Bad Request"
+      content:
+        "application/json":
+          schema:
+            $ref: "../schemas/ProblemDetail.yaml"