sure

.gitignore

@@ -1,7 +1,7 @@
 __pycache__/
 *.py[cod]
 *$py.class
-
+postman_collection.json
 *.so
 
 .Python

app/api/server.py

@@ -23,7 +23,7 @@ _START_TIME = time.time()
 
 async def _self_ping():
     import httpx
-    health_url = f"http://{_settings.host}:{_settings.port}/health"
+    health_url = "https://aetherbase-llm-ready-data.hf.space/health"
     while True:
         try:
             async with httpx.AsyncClient(timeout=30.0) as client:
@@ -34,7 +34,7 @@ async def _self_ping():
                     _logger.warning("Self-ping returned: %s - %s", health_url, response.status_code)
         except Exception as exc:
             _logger.error("Self-ping error: %s", exc)
-        await asyncio.sleep(3600)
+        await asyncio.sleep(900)
 
 
 @asynccontextmanager

app/api/v1/batch.py

@@ -68,7 +68,7 @@ def _batch_result_from_ok(result) -> BatchFileResult:
 )
 async def batch_files(
     files: Annotated[List[UploadFile], File(description="Files to convert")],
-    token: str = require_auth,
+    token: str = Depends(require_auth),
     converter_service: ConverterService = Depends(get_converter_service),
 ):
     if not files:
@@ -120,7 +120,7 @@ async def batch_files(
 )
 async def batch_urls(
     body: BatchUrlRequest,
-    token: str = require_auth,
+    token: str = Depends(require_auth),
     converter_service: ConverterService = Depends(get_converter_service),
 ):
     batch_start = time.perf_counter()

app/api/v1/convert.py

@@ -110,7 +110,7 @@ async def convert_file(
     plain_text: bool = Form(False),
     return_json: bool = Form(False),
     mappings: Optional[str] = Form(None, description="JSON string with field mappings"),
-    token: str = require_auth,
+    token: str = Depends(require_auth),
     converter_service: ConverterService = Depends(get_converter_service),
     extraction_service: ExtractionService = Depends(get_extraction_service),
 ):
@@ -160,7 +160,7 @@ async def convert_file(
 )
 async def convert_url(
     body: UrlRequest,
-    token: str = require_auth,
+    token: str = Depends(require_auth),
     converter_service: ConverterService = Depends(get_converter_service),
     extraction_service: ExtractionService = Depends(get_extraction_service),
 ):

app/api/v1/system.py

@@ -33,7 +33,7 @@ _START_TIME = time.time()
 
 @router.get("/health", response_model=HealthResponse, summary="Health check")
 async def health(
-    token: str = require_auth,
+    token: str = Depends(require_auth),
 ):
     return HealthResponse(
         success=True,
@@ -46,7 +46,7 @@ async def health(
 
 @router.get("/info", response_model=InfoResponse, summary="Server and environment information")
 async def info(
-    token: str = require_auth,
+    token: str = Depends(require_auth),
 ):
     return InfoResponse(
         success=True,
@@ -63,7 +63,7 @@ async def info(
 
 @router.get("/formats", response_model=SupportedFormatsResponse, summary="List supported file formats")
 async def list_formats(
-    token: str = require_auth,
+    token: str = Depends(require_auth),
 ):
     by_category = {
         "documents": [e for e in SUPPORTED_EXTENSIONS if e in DOCUMENT_EXTENSIONS],
@@ -85,7 +85,7 @@ async def list_formats(
 
 @router.get("/spacy-labels", response_model=SpacyLabelsResponse, summary="List available spaCy NER labels")
 async def list_spacy_labels(
-    token: str = require_auth,
+    token: str = Depends(require_auth),
     extraction_service: ExtractionService = Depends(get_extraction_service),
 ):
     return SpacyLabelsResponse(

app/core/security.py

@@ -14,7 +14,7 @@ async def require_api_key(
     api_key: str = Security(_security),
 ) -> str:
     settings = get_settings()
-    token = settings.API_KEY
+    token = settings.api_key
 
     if not api_key:
         _logger.warning("Missing x-api-key header")

postman_collection.json

@@ -2,7 +2,7 @@
     "info": {
         "_postman_id": "reconciliation-not-ai-extractor-service",
         "name": "Reconciliation-not-ai-extractor-service",
-        "description": "Production-ready Postman collection for the Document-to-Markdown and structured data extraction API powered by Microsoft MarkItDown, RapidOCR, and spaCy.\n\n**Base URL:** `{{base_url}}`\n**Authentication:** Bearer token via `{{api_bearer_token}}`\n\n## Endpoints\n- **System:** Health, info, supported formats, spaCy labels\n- **Convert:** Single file and single URL to Markdown\n- **Batch:** Bulk conversion of files and URLs",
+        "description": "Production-ready Postman collection for the Document-to-Markdown and structured data extraction API powered by Microsoft MarkItDown, RapidOCR, and spaCy.\n\n**Base URL:** `{{base_url}}`\n**Authentication:** API key via `x-api-key` header\n\n## Endpoints\n- **System:** Health, info, supported formats, spaCy labels\n- **Convert:** Single file and single URL to Markdown\n- **Batch:** Bulk conversion of files and URLs",
         "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
     },
     "item": [
@@ -17,10 +17,32 @@
                         "header": [],
                         "url": {
                             "raw": "{{base_url}}/health",
-                            "host": ["{{base_url}}"],
-                            "path": ["health"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "health"
+                            ]
+                        },
+                        "description": "Quick health check without authentication."
+                    },
+                    "response": []
+                },
+                {
+                    "name": "Ping (No Auth)",
+                    "request": {
+                        "method": "GET",
+                        "header": [],
+                        "url": {
+                            "raw": "{{base_url}}/ping",
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "ping"
+                            ]
                         },
-                        "description": "Quick health check without authentication. Returns `{\"status\": \"ok\", \"version\": \"1.0.0\"}`."
+                        "description": "Simple ping endpoint without authentication."
                     },
                     "response": []
                 },
@@ -30,17 +52,22 @@
                         "method": "GET",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
                         "url": {
                             "raw": "{{base_url}}/v1/health",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "health"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "health"
+                            ]
                         },
-                        "description": "Authenticated health check with uptime and timestamp."
+                        "description": "Authenticated health check."
                     },
                     "response": []
                 },
@@ -50,17 +77,22 @@
                         "method": "GET",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
                         "url": {
                             "raw": "{{base_url}}/v1/info",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "info"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "info"
+                            ]
                         },
-                        "description": "Server and environment information including app name, version, Python version, platform, max upload size, and supported extension count."
+                        "description": "Server and environment information."
                     },
                     "response": []
                 },
@@ -70,17 +102,22 @@
                         "method": "GET",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
                         "url": {
                             "raw": "{{base_url}}/v1/formats",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "formats"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "formats"
+                            ]
                         },
-                        "description": "List all supported file formats grouped by category: documents, office, data, web, text, images, audio, archives."
+                        "description": "List all supported file formats."
                     },
                     "response": []
                 },
@@ -90,17 +127,22 @@
                         "method": "GET",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
                         "url": {
                             "raw": "{{base_url}}/v1/spacy-labels",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "spacy-labels"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "spacy-labels"
+                            ]
                         },
-                        "description": "Available spaCy NER labels, source types (entity, regex, token_attr), and example field mappings for structured JSON extraction."
+                        "description": "Available spaCy NER labels and mappings."
                     },
                     "response": []
                 }
@@ -116,8 +158,8 @@
                         "method": "POST",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
@@ -128,34 +170,37 @@
                                     "key": "file",
                                     "type": "file",
                                     "src": "/path/to/your/document.pdf",
-                                    "description": "The file to convert (PDF, DOCX, XLSX, PPTX, etc.)"
+                                    "description": "The file to convert"
                                 },
                                 {
                                     "key": "plain_text",
                                     "value": "false",
-                                    "type": "text",
-                                    "description": "Return raw Markdown text instead of JSON wrapper (true/false)"
+                                    "type": "text"
                                 },
                                 {
                                     "key": "return_json",
                                     "value": "false",
-                                    "type": "text",
-                                    "description": "Also extract structured JSON using spaCy NER and regex (true/false)"
+                                    "type": "text"
                                 },
                                 {
                                     "key": "mappings",
-                                    "value": "{\"company\": {\"source_type\": \"entity\", \"label\": \"ORG\"}, \"person\": {\"source_type\": \"entity\", \"label\": \"PERSON\"}}",
-                                    "type": "text",
-                                    "description": "Optional JSON string defining field extraction mappings"
+                                    "value": "{\"company\":{\"source_type\":\"entity\",\"label\":\"ORG\"}}",
+                                    "type": "text"
                                 }
                             ]
                         },
                         "url": {
                             "raw": "{{base_url}}/v1/convert/file",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "convert", "file"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "convert",
+                                "file"
+                            ]
                         },
-                        "description": "Upload a single file and convert it to Markdown. Optionally enable structured JSON extraction with custom field mappings."
+                        "description": "Upload a single file and convert it to Markdown."
                     },
                     "response": []
                 },
@@ -165,8 +210,8 @@
                         "method": "POST",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             },
                             {
@@ -177,7 +222,7 @@
                         ],
                         "body": {
                             "mode": "raw",
-                            "raw": "{\n    \"url\": \"https://example.com/document.pdf\",\n    \"return_json\": false,\n    \"mappings\": {\n        \"company\": {\"source_type\": \"entity\", \"label\": \"ORG\"},\n        \"email\": {\"source_type\": \"regex\", \"pattern\": \"\\\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\\\.[A-Z|a-z]{2,}\\\\b\"}\n    }\n}",
+                            "raw": "{\n  \"url\": \"https://example.com/document.pdf\",\n  \"return_json\": false,\n  \"mappings\": {\n    \"company\": {\n      \"source_type\": \"entity\",\n      \"label\": \"ORG\"\n    }\n  }\n}",
                             "options": {
                                 "raw": {
                                     "language": "json"
@@ -186,10 +231,16 @@
                         },
                         "url": {
                             "raw": "{{base_url}}/v1/convert/url",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "convert", "url"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "convert",
+                                "url"
+                            ]
                         },
-                        "description": "Convert a remote document URL to Markdown. Optionally enable structured JSON extraction with custom field mappings."
+                        "description": "Convert a remote document URL to Markdown."
                     },
                     "response": []
                 }
@@ -205,8 +256,8 @@
                         "method": "POST",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             }
                         ],
@@ -216,23 +267,27 @@
                                 {
                                     "key": "files",
                                     "type": "file",
-                                    "src": "/path/to/your/document1.pdf",
-                                    "description": "First file (up to 10 files max)"
+                                    "src": "/path/to/document1.pdf"
                                 },
                                 {
                                     "key": "files",
                                     "type": "file",
-                                    "src": "/path/to/your/document2.docx",
-                                    "description": "Second file"
+                                    "src": "/path/to/document2.docx"
                                 }
                             ]
                         },
                         "url": {
                             "raw": "{{base_url}}/v1/batch/files",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "batch", "files"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "batch",
+                                "files"
+                            ]
                         },
-                        "description": "Upload and convert up to 10 files in a single request. Returns aggregated results with per-file success/failure status."
+                        "description": "Upload and convert multiple files."
                     },
                     "response": []
                 },
@@ -242,8 +297,8 @@
                         "method": "POST",
                         "header": [
                             {
-                                "key": "Authorization",
-                                "value": "Bearer {{api_bearer_token}}",
+                                "key": "x-api-key",
+                                "value": "{{api_key}}",
                                 "type": "text"
                             },
                             {
@@ -254,7 +309,7 @@
                         ],
                         "body": {
                             "mode": "raw",
-                            "raw": "{\n    \"urls\": [\n        \"https://example.com/report1.pdf\",\n        \"https://example.com/report2.docx\"\n    ]\n}",
+                            "raw": "{\n  \"urls\": [\n    \"https://example.com/report1.pdf\",\n    \"https://example.com/report2.docx\"\n  ]\n}",
                             "options": {
                                 "raw": {
                                     "language": "json"
@@ -263,10 +318,16 @@
                         },
                         "url": {
                             "raw": "{{base_url}}/v1/batch/urls",
-                            "host": ["{{base_url}}"],
-                            "path": ["v1", "batch", "urls"]
+                            "host": [
+                                "{{base_url}}"
+                            ],
+                            "path": [
+                                "v1",
+                                "batch",
+                                "urls"
+                            ]
                         },
-                        "description": "Convert up to 20 URLs in a single request. Returns aggregated results with per-URL success/failure status."
+                        "description": "Convert multiple URLs."
                     },
                     "response": []
                 }
@@ -279,16 +340,16 @@
             "script": {
                 "type": "text/javascript",
                 "exec": [
-                    "// Validate required environment variables before each request",
-                    "const baseUrl = pm.environment.get('base_url');",
-                    "const token = pm.environment.get('api_bearer_token');",
+                    "// Validate required collection variables before each request",
+                    "const baseUrl = pm.collectionVariables.get('base_url');",
+                    "const apiKey = pm.collectionVariables.get('api_key');",
                     "",
                     "if (!baseUrl) {",
-                    "    pm.expect.fail('Missing environment variable: base_url');",
+                    "    pm.expect.fail('Missing collection variable: base_url');",
                     "}",
                     "",
-                    "if (!token && pm.request.url.path.join('/').startsWith('v1')) {",
-                    "    pm.expect.fail('Missing environment variable: api_bearer_token');",
+                    "if (!apiKey && pm.request.url.path.join('/').startsWith('v1')) {",
+                    "    pm.expect.fail('Missing collection variable: api_key');",
                     "}"
                 ]
             }
@@ -299,23 +360,28 @@
             "key": "base_url",
             "value": "http://localhost:7860",
             "type": "string",
-            "description": "Base URL of the Reconciliation-not-ai-extractor-service (e.g., http://localhost:7860 or your deployed URL)"
+            "description": "Base URL of the service"
         },
         {
-            "key": "api_bearer_token",
+            "key": "api_key",
             "value": "changeme",
             "type": "string",
-            "description": "API bearer token for authenticated endpoints. Must match the service's API_BEARER_TOKEN environment variable."
+            "description": "API key for authenticated endpoints"
         }
     ],
     "auth": {
-        "type": "bearer",
-        "bearer": [
+        "type": "apikey",
+        "apikey": [
+            {
+                "key": "value",
+                "value": "{{api_key}}",
+                "type": "string"
+            },
             {
-                "key": "token",
-                "value": "{{api_bearer_token}}",
+                "key": "key",
+                "value": "x-api-key",
                 "type": "string"
             }
         ]
     }
-}
+}