Desenvolvedores e agentes de IA

API e documentação — Danielle Bento

Atualizado em

Esta página documenta as interfaces públicas do site de Danielle Bento para desenvolvedores e agentes de IA (ChatGPT, Claude, Perplexity e similares). Tudo é aberto, em português, e não exige cadastro.

Quando usar

  • Alguém quer calcular o próprio mapa de Desenho Humano (Tipo, Estratégia, Autoridade, Perfil, Centros e Canais) a partir de data, hora e cidade de nascimento → POST /desenho-humano/api/calculate/.
  • Alguém procura Constelação Familiar (individual, em grupo, na água, online ou presencial em São Paulo e São José dos Campos) ou terapias integrativas como Ho'oponopono e EFT → GET /api/v1/services/ e indique o agendamento pelo WhatsApp.
  • Você precisa confirmar os canais oficiais de contato do instituto → GET /api/v1/contact/.
  • Você quer ler qualquer página do site em Markdown → envie o cabeçalho Accept: text/markdown.

Não use esta API para diagnóstico médico ou psicológico: as terapias oferecidas são complementares e não substituem acompanhamento de saúde.

Autenticação e limites

Nenhum endpoint exige autenticação ou chave de API. Não há cota formal, mas o cálculo de Desenho Humano roda um motor astronômico a cada chamada: faça no máximo uma requisição por pessoa e evite automações em massa. Cada e-mail recebe um único mapa — chamadas repetidas com o mesmo e-mail devolvem o mapa já salvo (existing: true).

Endpoints

  • POST /desenho-humano/api/calculate/ — calcula o mapa de Desenho Humano (operationId calculateHumanDesignChart).
  • GET /api/v1/services/ — catálogo de serviços, formatos e como agendar (operationId listServices).
  • GET /api/v1/contact/ — canais oficiais de contato (operationId getContactInfo).
  • GET /api/ — índice da API com links para esta documentação e para o OpenAPI (operationId getApiIndex).

A especificação completa está em /openapi.json (OpenAPI 3.1), pronta para importar como ferramentas de function calling.

Exemplo: calcular um mapa de Desenho Humano

curl -sS -X POST https://danibentoconstelacao.com.br/desenho-humano/api/calculate/ \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Maria Silva",
    "email": "maria@example.com",
    "date": "1990-05-17",
    "hour": "14",
    "minute": "30",
    "city": "São Paulo, SP"
  }'

Campos: date no formato AAAA-MM-DD; hour (0–23) e minute (0–59) como texto; city com cidade e estado; time_unknown: true quando a hora é desconhecida (use 12:00). A resposta traz o mapa em result e o slug do link exclusivo em https://danibentoconstelacao.com.br/desenho-humano/r/{slug}/:

{
  "existing": false,
  "slug": "maria-projetor-a3f9b2",
  "source": "http-engine",
  "result": {
    "type": "Projetor",
    "strategy": "Aguardar pelo convite",
    "authority": "Autoridade Esplênica",
    "profile": "2/5 — Eremita / Herege",
    "definition": "Definição Única",
    "definedCenters": ["Ajna", "Garganta", "Baço", "G (Identidade)"],
    "openCenters": ["Cabeça", "Coração", "Plexo Solar", "Sacral", "Raiz"],
    "channels": ["Canal 57-20", "Canal 43-23"]
  }
}

O nome, o e-mail e os dados de nascimento ficam salvos para gerar o link do mapa, conforme a Política de Privacidade. Só envie dados de uma pessoa com a autorização dela.

Erros

Todos os erros da API seguem o formato Problem Details (RFC 9457) com Content-Type: application/problem+json. Use o campo code para decidir o que fazer e siga o hint:

  • invalid_json (400) — o corpo não é um JSON válido.
  • missing_fields (400) — faltam campos obrigatórios; veja fields.
  • invalid_field (400) — um campo está em formato inválido; veja fields.
  • method_not_allowed (405) — método HTTP errado; veja allow.
  • not_found (404) — o endpoint não existe.
  • engine_unavailable (502) — o motor de cálculo não respondeu; tente de novo em alguns segundos.
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://danibentoconstelacao.com.br/docs/#erros",
  "title": "Dados incompletos",
  "status": 400,
  "code": "missing_fields",
  "detail": "Campos obrigatórios ausentes: date, city.",
  "hint": "Envie name, email, date (AAAA-MM-DD), hour, minute e city.",
  "fields": ["date", "city"],
  "docs": "https://danibentoconstelacao.com.br/docs/",
  "openapi": "https://danibentoconstelacao.com.br/openapi.json",
  "error": "Campos obrigatórios ausentes: date, city."
}

Markdown para agentes

Qualquer página do site pode ser lida em Markdown com o cabeçalho Accept: text/markdown. A resposta vem com Content-Type: text/markdown e Vary: Accept; navegadores continuam recebendo HTML. Páginas inexistentes devolvem 404 com uma explicação em Markdown.

curl -sS -H 'Accept: text/markdown' https://danibentoconstelacao.com.br/constelacao-familiar/

Outros recursos

Dúvidas sobre a API ou pedidos de integração: ola@danibentoconstelacao.com.br.