Consulta pública para sites e agentes
REST somente leitura
Todos os recursos aceitam GET, HEAD e OPTIONS. PUT, PATCH, DELETE e POST recebem 405. Nas buscas, o único parâmetro permitido é q, opcional, uma vez, com até 120 caracteres. Não envie dados pessoais ou clínicos.
| Recurso | Conteúdo |
|---|---|
| /api/v1/services | Serviços publicados; aceita q |
| /api/v1/content | Páginas públicas; aceita q |
| /api/v1/site | Endereço, formação e contatos por página |
| /api/v1/status | Disponibilidade deste catálogo |
Contrato OpenAPI 3.1 · Catálogo RFC 9727 · Acesso e limites
HTML e Markdown
As duas páginas oferecem a mesma informação editorial em HTML e Markdown. Envie Accept: text/markdown; HTML vence empates. Respostas variam por Accept e incluem ETag. Use If-None-Match para revalidação. HEAD devolve os mesmos cabeçalhos sem corpo.
Home em Markdown · Implantes em Markdown · Índice para agentes
MCP
O endpoint /mcp usa o SDK oficial e transporte Streamable HTTP stateless, com POST e OPTIONS. POST transporta mensagens de consulta; não grava dados. Envie Content-Type: application/json e Accept: application/json, text/event-stream. Faça initialize antes de usar ferramentas.
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"catalog-reader","version":"1.0"}}}Ferramentas: list_services, find_content e get_site_info. As duas primeiras aceitam q. Recursos: services, content e site. Não há prompts clínicos, autenticação fictícia, sessões persistentes ou agendamentos.
Server card · Três skills com SHA-256 · Catálogo de IA
Server cards e catálogo de IA são formatos experimentais de descoberta. WebMCP é ativado somente em navegadores que oferecem a API, com as mesmas consultas públicas. Esses recursos não garantem indexação ou citação por assistentes.
Limites de operação
Não há coleta de pacientes nem chamada para WordPress, Google Ads ou sistemas da clínica. Os links retornados operam neste host; canonicalUrl identifica o domínio futuro. A origem WordPress atual permanece independente. A hospedagem pode manter logs normais de requisições. Nunca inclua dados de pacientes em parâmetros.