Docs e API pública
Esta página descreve a superfície pública da Nutrali para agentes de IA e integrações. Não há GraphQL público. Endpoints autenticados do consultório (/api/org/*, painel) exigem login do nutricionista e não devem ser chamados sem sessão.
Spec máquina: /openapi.json. Brief para LLMs: /llms.txt.
Quando usar
- Listar planos SaaS e trial
- Ler página pública publicada de um slug
- Criar lead, pedido de agenda ou anamnese na landing do nutri
- Descobrir a marca Nutrali e apontar humanos ao cadastro
Endpoints públicos
| Método | Path | Descrição |
|---|---|---|
| GET | /api/public/saas-plans | Planos e trial |
| GET | /api/public/u/{slug} | Página pública |
| GET | /api/public/u/{slug}/slots | Horários |
| POST | /api/public/u/{slug}/leads | Lead |
| POST | /api/public/u/{slug}/bookings | Agendamento |
| POST | /api/public/u/{slug}/anamnesis | Anamnese |
| POST | /api/public/u/{slug}/challenges/{challengeSlug}/enroll | Desafio |
Erros: JSON { "error": { "code", "message", "hint?" } }. Rotas inexistentes em /api/* também devolvem esse formato (HTTP 404).
Segurança
- Não há API pública de prontuário ou lista de pacientes
- Rate limit em leads/bookings/anamnese/desafios
- Negociação Markdown: envie
Accept: text/markdownem /, /docs, /sobre, /contato
Exemplos
curl -s https://nutrali.co/api/public/saas-plans | head curl -s -H 'Accept: text/markdown' https://nutrali.co/ curl -s https://nutrali.co/openapi.json | head
Cadastro humano: /cadastro.