{
  "openapi": "3.1.0",
  "info": {
    "title": "HC Ergonomia API Gateway & Agent Knowledge Service",
    "description": "APIs públicas e catálogo de serviços da HC Ergonomia para consulta de dados periciais em SST, conformidade com as Normas Regulamentadoras NR-1, NR-17 e NR-36, e cotação de serviços corporativos em Cuiabá e Mato Grosso.",
    "version": "1.0.0",
    "contact": {
      "name": "HC Ergonomia - Suporte Técnico",
      "url": "https://hcergonomia.com.br/contato",
      "email": "contato@hcergonomia.com.br"
    }
  },
  "servers": [
    {
      "url": "https://hcergonomia.com.br",
      "description": "Servidor de Produção Oficial"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "summary": "Verificação de Saúde da API (Health Check)",
        "description": "Retorna o status operacional da API e dos serviços integrados.",
        "operationId": "getHealthStatus",
        "responses": {
          "200": {
            "description": "Serviço operacional",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": { "type": "string", "example": "healthy" },
                    "timestamp": { "type": "string", "format": "date-time" },
                    "service": { "type": "string", "example": "HC Ergonomia API Gateway" },
                    "version": { "type": "string", "example": "1.0.0" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/ai-knowledge": {
      "get": {
        "summary": "Base de Conhecimento Pericial para Agentes de IA",
        "description": "Entrega dados canônicos sobre NR-1, NR-17, laudos AET/AEP, perícias e atuação regional em Cuiabá e Mato Grosso para LLMs e agentes autônomos.",
        "operationId": "getAiKnowledge",
        "responses": {
          "200": {
            "description": "Base de conhecimento em formato estruturado",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/lead": {
      "post": {
        "summary": "Solicitação de Cotação e Proposta de Laudo Pericial",
        "description": "Recebe solicitações comerciais de empresas para elaboração de Laudos AET, AEP, Gestão de Riscos NR-1 e consultoria em MT.",
        "operationId": "submitLead",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["nome", "contato"],
                "properties": {
                  "nome": { "type": "string", "example": "João da Silva" },
                  "empresa": { "type": "string", "example": "Agropecuária Mato Grosso S/A" },
                  "contato": { "type": "string", "example": "65999999999" },
                  "email": { "type": "string", "format": "email", "example": "diretoria@agro.com.br" },
                  "cidade": { "type": "string", "example": "Cuiabá" },
                  "mensagem": { "type": "string", "example": "Necessitamos de Laudo AET para 45 postos operacionais." }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Lead recebido com sucesso",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean", "example": true },
                    "message": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/markdown-negotiation": {
      "get": {
        "summary": "Representação em Markdown para Agentes de IA",
        "description": "Retorna o conteúdo da página solicitada em formato limpo text/markdown mediante negociação de conteúdo (Accept: text/markdown).",
        "operationId": "getMarkdownRepresentation",
        "parameters": [
          {
            "name": "targetPath",
            "in": "query",
            "required": false,
            "description": "Caminho da rota original (ex: /servicos/nr-17-cuiaba)",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Conteúdo textual puro em Markdown para agentes",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "Catálogo de APIs RFC 9727",
        "description": "Catálogo de descoberta automatizada de APIs em formato application/linkset+json.",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "Linkset RFC 9727",
            "content": {
              "application/linkset+json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "linkset": {
                      "type": "array",
                      "items": { "type": "object" }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}