{
  "openapi": "3.0.3",
  "info": {
    "title": "API Pública de Transparência - Esquadrão da Vida",
    "version": "1.0.0",
    "description": "Consulta automatizada de informações públicas. Não expõe prontuários, mensagens de formulários, dados pessoais internos ou registros administrativos privados."
  },
  "servers": [{"url": "https://www.esquadraodavidabauru.com.br"}],
  "paths": {
    "/api/transparencia/v1": {
      "get": {
        "summary": "Consultar catálogo público",
        "parameters": [
          {"name":"q","in":"query","schema":{"type":"string"},"description":"Pesquisa textual"},
          {"name":"categoria","in":"query","schema":{"type":"string"},"description":"Chave da categoria documental"},
          {"name":"tipo","in":"query","schema":{"type":"string"},"description":"Tipo de registro estruturado"},
          {"name":"ano","in":"query","schema":{"type":"integer"},"description":"Exercício/ano"},
          {"name":"pagina","in":"query","schema":{"type":"integer","minimum":1,"default":1}},
          {"name":"limite","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},
          {"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"ETag recebido em consulta anterior para revalidação condicional"}
        ],
        "responses": {
          "200": {"description":"Catálogo público em JSON","headers":{"ETag":{"description":"Identificador da versão do conteúdo","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}},
          "304": {"description":"Conteúdo não modificado conforme ETag"}
        }
      },
      "head": {"summary":"Consultar cabeçalhos e ETag","responses":{"200":{"description":"Cabeçalhos da versão atual"},"304":{"description":"Não modificado"}}}
    }
  }
}