Add Swagger docs at /docs and /openapi.json with split OpenAPI spec

Made-with: Cursor
2026-02-28 21:14:27 -03:00
parent bdb4892014
commit 0a6d86c8e8
21 changed files with 679 additions and 0 deletions
--- a/backend/openapi/path-items/claim-confirm.yaml
+++ b/backend/openapi/path-items/claim-confirm.yaml
@@ -0,0 +1,39 @@
+post:
+  tags: [Claim]
+  summary: Confirm quote and pay (rate limited)
+  security:
+    - BearerAuth: []
+  requestBody:
+    content:
+      application/json:
+        schema:
+          type: object
+          required: [quote_id]
+          properties:
+            quote_id:
+              type: string
+  responses:
+    "200":
+      description: Success or already consumed
+      content:
+        application/json:
+          schema:
+            $ref: "../components/schemas/claim.yaml#/ConfirmResult"
+    "400":
+      description: Invalid request
+      content:
+        application/json:
+          schema:
+            $ref: "../components/schemas/common.yaml#/ApiError"
+    "404":
+      description: Quote not found or expired
+      content:
+        application/json:
+          schema:
+            $ref: "../components/schemas/common.yaml#/ApiError"
+    "502":
+      description: Lightning payment failed
+      content:
+        application/json:
+          schema:
+            $ref: "../components/schemas/common.yaml#/ApiError"