Fix API docs: ensure HTTPS, add /api/predict endpoint to README

POSTMAN_TESTING_GUIDE.md

@@ -109,9 +109,12 @@ If you want to use `/api/upload` for async processing:
 ## Quick Test with cURL
 
 ```bash
+# Test with HTTPS (required for Hugging Face Spaces)
 curl -X POST https://saifisvibin-volaris-pdf-tool.hf.space/api/predict \
   -F "file=@your_document.pdf"
 ```
 
+**Important:** Always use `https://` (not `http://`) when accessing Hugging Face Spaces. The platform automatically redirects HTTP to HTTPS, but you should use HTTPS directly.
+
 Replace `your_document.pdf` with your actual PDF file path.
 

README.md

@@ -23,20 +23,41 @@ A powerful tool for extracting figures, tables, annotated layouts, and markdown
 
 ## API Endpoints
 
-- `POST /api/upload` - Upload PDFs for processing (returns `task_id`)
+**Base URL:** `https://saifisvibin-volaris-pdf-tool.hf.space`
+
+- `POST /api/predict` - **Recommended**: Synchronous PDF extraction (returns complete results immediately)
+- `POST /api/upload` - Upload PDFs for async processing (returns `task_id`)
 - `GET /api/progress/<task_id>` - Get processing progress (0-100%)
 - `GET /api/pdf-list` - List all processed PDFs
 - `GET /api/pdf-details/<pdf_stem>` - Get details for a processed PDF
 - `GET /api/device-info` - Get GPU/CPU device information
+- `GET /api/docs` - Interactive API documentation
 - `GET /output/<path>` - Download processed files (PDFs, images, markdown)
 
 ## Example API Usage
 
+### Simple Synchronous Extraction (Recommended)
+
+```python
+import requests
+
+# Upload and get results immediately
+files = {'file': open('document.pdf', 'rb')}
+response = requests.post('https://saifisvibin-volaris-pdf-tool.hf.space/api/predict', files=files)
+result = response.json()
+
+print(f"Text: {result['text']}")
+print(f"Figures: {len(result['figures'])}")
+print(f"Tables: {len(result['tables'])}")
+```
+
+### Async Processing with Progress
+
 ```python
 import requests
 import time
 
-# Upload a PDF
+# Upload a PDF (async)
 files = {'files[]': open('document.pdf', 'rb')}
 data = {'extraction_mode': 'both'}  # or 'images' or 'markdown'
 response = requests.post('https://saifisvibin-volaris-pdf-tool.hf.space/api/upload', files=files, data=data)

app.py

@@ -85,7 +85,10 @@ def api_docs():
                 'description': doc.strip() if doc else 'No description'
             })
     
+    # Force HTTPS for Hugging Face Spaces (always use HTTPS)
     base_url = request.host_url.rstrip('/')
+    if base_url.startswith('http://'):
+        base_url = base_url.replace('http://', 'https://')
     return render_template('api_docs.html', routes=routes, base_url=base_url)