Documentação de API & Recursos para Agentes de IA
Esta página descreve a infraestrutura pública de dados e serviços programáticos do site da psicóloga clínica Jamille Ovadia Moraes (CRP-04/75728), permitindo que agentes autônomos, modelos de linguagem (LLMs) e plataformas de busca obtenham informações precisas, estruturadas e atualizadas sobre o consultório, especialidades, serviços e agendamentos.
1. Autenticação & Políticas de Acesso
Todos os endpoints de consulta são públicos e não exigem chave de autenticação (API Key). Não há limitação restritiva de taxa para agentes legítimos identificados (como GPTBot, ClaudeBot, PerplexityBot e outros). Respostas são servidas com compressão DEFLATE e cabeçalhos de segurança HTTP.
2. Arquivos de Especificação & Agentes
- OpenAPI 3.1.0 (JSON):
/openapi.json— Especificação canônica completa e validada com esquemas tipados eoperationIdúnicos para tool calling. - OpenAPI 3.1.0 (YAML):
/api/openapi.yaml— Versão legível em YAML para frameworks de agentes. - Instruções para Agentes (llms.txt):
/llms.txt— Resumo conciso de contexto e casos de uso recomendados (protocolo llms.txt). - Guia Estendido (llms-full.txt):
/llms-full.txt— Contexto exaustivo e árvore de decisão para assistentes clínicos. - Negociação de Conteúdo Markdown: A home (
https://www.psijamilleom.com.br/) responde diretamente com Markdown quando requisitada com o cabeçalhoAccept: text/markdown, emitindo o cabeçalhoVary: Accept, Accept-Encoding.
3. Endpoints da API REST (v1)
GET /api/v1/profile
Operation ID: getPsychologistProfile
Retorna os dados cadastrais, registro CRP-04/75728, 14 anos de experiência, abordagens terapêuticas (Terapia Sistêmica, Terapia do Esquema), endereço físico no Edifício Acaiaca (Belo Horizonte) e canais oficiais de contato.
curl -H "Accept: application/json" https://www.psijamilleom.com.br/api/v1/profileGET /api/v1/services
Operation ID: getTherapyServices
Retorna as modalidades terapêuticas disponíveis (Psicoterapia Individual, Terapia de Casal, Vínculos Não Monogâmicos), duração de 50 minutos por sessão e orientações sobre honorários particulares e recibos de reembolso.
curl -H "Accept: application/json" https://www.psijamilleom.com.br/api/v1/servicesGET /api/v1/faq
Operation ID: getFrequentlyAskedQuestions
Retorna perguntas frequentes com respostas completas sobre primeira sessão, frequência semanal, formato online e política de convênios.
curl -H "Accept: application/json" https://www.psijamilleom.com.br/api/v1/faqPOST /api/v1/inquire
Operation ID: submitAppointmentInquiry
Permite a um agente ou integração submeter os dados iniciais de um paciente interessado e receber o link formatado direto para o WhatsApp da psicóloga.
curl -X POST https://www.psijamilleom.com.br/api/v1/inquire \
-H "Content-Type: application/json" \
-d '{"name": "Ana", "modality": "individual", "format": "presencial_bh"}'4. Formato Padronizado de Erros JSON
Todas as requisições para rotas sob /api/* que resultem em erro ou recursos inexistentes retornam sempre Content-Type: application/json com estrutura previsível:
{
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "O endpoint solicitado não foi encontrado nesta API.",
"resolution": "Consulte a documentação completa da API em https://www.psijamilleom.com.br/docs ou a especificação OpenAPI em https://www.psijamilleom.com.br/openapi.json."
}
}