Add static directory with OpenAPI spec

static/openapi.yaml

@@ -0,0 +1,68 @@
+openapi: 3.1.0
+info:
+  title: PDF RAG API
+  version: 1.0.0
+  description: API to query a Weaviate vector DB using SentenceTransformer embeddings
+
+servers:
+  - url: https://vignesh45--pdf-rag-api.hf.space
+
+paths:
+  /:
+    get:
+      summary: Health check
+      operationId: root
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+
+    post:
+      summary: Query the vector DB with a text prompt
+      operationId: queryWeaviate
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                text:
+                  type: string
+                  minLength: 1
+                top_k:
+                  type: integer
+                  default: 7
+                  minimum: 1
+                  maximum: 100
+              required:
+                - text
+      responses:
+        '200':
+          description: Query results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  query:
+                    type: string
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        text:
+                          type: string
+                        source:
+                          type: string
+        '400':
+          description: Bad request
+        '500':
+          description: Internal server error