Add remote test and Postman collection

README.md

@@ -84,6 +84,16 @@ docker run -p 7860:7860 --env-file .env ddgs-api
 
 Note: `certif_zscaler/` is excluded from the Docker build context via `.dockerignore`. Zscaler is only used locally when `USE_LOCAL_ZSCALER_CERT=true`. HF deployments will not load Zscaler certs.
 
+## Remote test
+
+```bash
+test_scripts/test_remote_api.sh https://dromerosm-ddgs.hf.space <api_bearer_token>
+```
+
+## Postman
+
+Import `postman_collection.json`. The Authorization header has an empty Bearer token by default.
+
 ## Environment variables
 
 - `DDGS_REGION`

postman_collection.json

@@ -0,0 +1,50 @@
+{
+  "info": {
+    "name": "DDGS Search API",
+    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+  },
+  "item": [
+    {
+      "name": "Search",
+      "request": {
+        "method": "POST",
+        "header": [
+          {
+            "key": "Authorization",
+            "value": "Bearer ",
+            "type": "text"
+          },
+          {
+            "key": "Content-Type",
+            "value": "application/json",
+            "type": "text"
+          }
+        ],
+        "body": {
+          "mode": "raw",
+          "raw": "{\n  \"query\": \"openai\",\n  \"max_results\": 1,\n  \"region\": \"us-en\",\n  \"safesearch\": \"moderate\",\n  \"timelimit\": \"m\",\n  \"backend\": \"auto\",\n  \"timeout\": 30,\n  \"verify\": true\n}",
+          "options": {
+            "raw": {
+              "language": "json"
+            }
+          }
+        },
+        "url": {
+          "raw": "{{base_url}}/search",
+          "host": [
+            "{{base_url}}"
+          ],
+          "path": [
+            "search"
+          ]
+        }
+      }
+    }
+  ],
+  "variable": [
+    {
+      "key": "base_url",
+      "value": "https://dromerosm-ddgs.hf.space"
+    }
+  ]
+}

test_scripts/test_remote_api.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ $# -lt 2 ]; then
+  echo "Usage: $0 <base_url> <api_bearer_token>" >&2
+  echo "Example: $0 https://dromerosm-ddgs.hf.space <token>" >&2
+  exit 1
+fi
+
+BASE_URL="$1"
+TOKEN="$2"
+
+curl -s -X POST "$BASE_URL/search" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"query":"openai","max_results":1,"region":"us-en","safesearch":"moderate","timelimit":"m","backend":"auto","timeout":30,"verify":true}' \
+  | python -c 'import json,sys; payload=json.load(sys.stdin); print("OK", payload.get("count"))'