{
  "service": "headers.tools.town",
  "version": "1.0.0",
  "description": "Fetch HTTP response headers from the edge — browsers hide most cross-origin headers even when CORS allows the body.",
  "limits": {
    "max_url_chars": 2048,
    "fetch_timeout_ms": 12000,
    "default_redirect_mode": "manual (first hop only)"
  },
  "endpoints": {
    "docs_html": "GET /",
    "headers": "GET /v1/headers?url=&follow=",
    "validate": "GET /v1/validate?url=",
    "embed_widget": "GET /embed/",
    "health": "GET /health",
    "discovery": "GET /meta"
  },
  "query_params": {
    "url": "Target URL (required). https assumed if scheme omitted.",
    "follow": "If 1/true/yes, follow redirects and return final response headers."
  },
  "examples": {
    "first_hop": "https://headers.tools.town/v1/headers?url=https://github.com",
    "follow": "https://headers.tools.town/v1/headers?url=https://github.com&follow=1"
  }
}