Enhance API documentation with detailed request/response formats

main.py

@@ -1,4 +1,4 @@
-from fastapi import FastAPI, File, UploadFile, HTTPException, Depends, Header, Form
+from fastapi import FastAPI, File, UploadFile, HTTPException, Depends, Header, Form, status
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import JSONResponse
 from datetime import datetime
@@ -41,10 +41,93 @@ app = FastAPI(
     * Customer access requires API key
     
     ## API Endpoints
-    * POST /api/v1/process-call - Process a voice call recording
-    * GET /api/v1/calls - List all calls for a customer
-    * GET /api/v1/calls/{call_id} - Get specific call details
-    * GET /api/v1/health - Health check endpoint
+    
+    ### Call Processing
+    * POST /api/v1/process-call
+      - Process a voice call recording
+      - Requires: WAV file, caller number, called number
+      - Returns: Transcription, summary, sentiment analysis
+    
+    ### Call Management
+    * GET /api/v1/calls
+      - List all calls for a customer
+      - Optional filters: start_date, end_date
+      - Returns: List of call records
+    
+    * GET /api/v1/calls/{call_id}
+      - Get specific call details
+      - Returns: Detailed call record
+    
+    * GET /api/v1/calls/search
+      - Search calls with custom query
+      - Returns: Matching call records
+    
+    ### Admin Operations
+    * POST /api/v1/customers/
+      - Create new customer
+      - Requires: name, company_name, email
+      - Returns: Customer details with API key
+    
+    * GET /api/v1/customers
+      - List all customers
+      - Returns: List of customer records
+    
+    * GET /api/v1/customers/{customer_id}
+      - Get customer details
+      - Returns: Customer record
+    
+    * DELETE /api/v1/customers/{customer_id}
+      - Delete customer
+      - Returns: Success message
+    
+    ### System
+    * GET /api/v1/health
+      - Health check endpoint
+      - Returns: System status
+    
+    ## Request/Response Formats
+    
+    ### Process Call
+    ```json
+    POST /api/v1/process-call
+    Headers: {
+      "X-API-Key": "your-api-key"
+    }
+    Body: {
+      "file": <wav_file>,
+      "caller_number": "string",
+      "called_number": "string"
+    }
+    Response: {
+      "id": "uuid",
+      "transcription": "string",
+      "summary": "string",
+      "sentiment": "string",
+      "timestamp": "datetime"
+    }
+    ```
+    
+    ### Create Customer
+    ```json
+    POST /api/v1/customers/
+    Headers: {
+      "Authorization": "Bearer <admin_token>"
+    }
+    Body: {
+      "name": "string",
+      "company_name": "string",
+      "email": "string"
+    }
+    Response: {
+      "id": "integer",
+      "name": "string",
+      "company_name": "string",
+      "email": "string",
+      "api_key": "string",
+      "is_active": "boolean",
+      "created_at": "datetime",
+      "updated_at": "datetime"
+    }
     """,
     version="1.0.0"
 )