{
  "openapi": "3.0.3",
  "info": {
    "title": "万霖消防湖南站 GEO Evidence API",
    "version": "1.1.0",
    "description": "查询经过人工核验的湖南消防政策原子证据。结果包含证据ID、来源、适用地域、核验日期和适用边界。"
  },
  "servers": [{"url": "https://www.hunanxiaofang.net"}],
  "paths": {
    "/geo/query/": {
      "get": {
        "summary": "按自然语言关键词查询证据",
        "parameters": [{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80},"example":"消防控制室值班"}],
        "responses": {"200":{"description":"匹配的核验证据","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryResponse"}}}}}
      }
    },
    "/geo/status/": {
      "get": {
        "summary": "查看数据健康状态",
        "parameters": [{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json"]}}],
        "responses": {"200":{"description":"健康状态","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}
      }
    },
    "/geo/manifest/": {"get":{"summary":"获取数据文件SHA256清单","responses":{"200":{"description":"文件清单"}}}}
  },
  "components": {
    "schemas": {
      "Evidence": {"type":"object","required":["id","claim","source","verified_at","boundary"],"properties":{"id":{"type":"string","example":"HN-FIRE-002"},"claim":{"type":"string"},"jurisdiction":{"type":"string"},"source":{"type":"object"},"verified_at":{"type":"string","format":"date"},"boundary":{"type":"string"}}},
      "QueryResponse": {"type":"object","required":["api_version","query","result_count","results"],"properties":{"api_version":{"type":"string"},"query":{"type":"string"},"result_count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}}}},
      "HealthResponse": {"type":"object","required":["status","checked_at","evidence_count","checks"],"properties":{"status":{"type":"string","enum":["healthy","degraded"]},"checked_at":{"type":"string","format":"date-time"},"evidence_count":{"type":"integer"},"checks":{"type":"array","items":{"type":"object"}}}}
    }
  }
}
