API de Design Humano: construa aplicativos HD em 12 endpoints

🕓 Registo de 2026-04-14, atualizado em 2026-05-09. TS / Python / PHP SDK agora vivem nos registros públicos — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Detalhes em changelog.

O Design Humano cresceu de um sistema esotérico de nicho nos anos 90 para uma estrutura de desenvolvimento pessoal mainstream. Aplicativos com milhões de usuários o normalizaram — e os desenvolvedores estão se perguntando: como calcular o mapa do Design Humano programaticamente?

Neste post, vamos explorar o lado técnico: o que são cálculos de Design Humano, quais APIs os suportam e como incorporar recursos de Design Humano no seu aplicativo.

O Design Humano é construído em três sistemas clássicos:

• Astrologia Ocidental — posições dos planetas no momento do nascimento
• I Ching — 64 hexagramas, mapeados para 64 “portas”
• Sistema de Chakras — nove “centros” (nós energéticos)

Os cálculos tomam os dados de nascimento e produzem um bodygraph — um mapa visual com:

• Tipo (Manifestor, Gerador, Gerador Manifestante, Projetor, Reflexor) — assinatura energética
• Estratégia — como tomar decisões
• Autoridade — qual centro confiar ao tomar decisões (Sacral, Emocional, Esplênico, etc.)
• Perfil — combinação de linhas (1/3, 4/6, etc.)
• Canais — ligações entre centros que formam a personalidade
• Cruz de Encarnação — propósito da vida, derivado de quatro posições-chave

Por baixo dos panos, cada uma das 64 portas corresponde a um intervalo de longitude eclíptica. A longitude dos planetas no nascimento é mapeada para portas específicas (e linhas dentro delas). O cálculo do “Design” — para o deslocamento do Sol em 88° antes do nascimento — é aproximadamente 3 meses antes.

O Design Humano usa dois momentos de nascimento:

1. Personalidade — o momento real do nascimento. Este é o lado “consciente”.
2. Design — quando o Sol estava a 88° antes da posição do nascimento. Este é o lado “inconsciente”.

Cada ativação de porta pertence a um deles. O mapa completo tem 13 + 13 = 26 ativações.

É isso que torna os cálculos de Design Humano mais difíceis do que um mapa astrológico padrão — você está efetivamente calculando dois mapas.

A maioria das APIs de astrologia ou não suporta o Design Humano ou tem um suporte superficial (apenas tipo + estratégia). Uma implementação completa do Design Humano requer:

• Mapeamento das 64 portas (tabela de pesquisa)
• 6 linhas para cada porta (384 células)
• 9 centros com lógica definida/aberta
• 36 canais (cada um conecta dois centros)
• Cálculo da Cruz de Encarnação
• Saída do Perfil com a linha da porta do Sol + linha da porta da Terra (Personalidade e Design)

As APIs que podem fazer tudo isso são uma raridade. A API AstroWay tem 12 endpoints de Design Humano — a cobertura mais profunda que já vimos em uma API comercial.

Imagine que você está adicionando o Design Humano a um aplicativo astrológico existente. Comece com o endpoint principal:

import { Astroway } from '@astroway/sdk';

const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const hd = await client.humanDesign({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Tipo: ${hd.type}`);         // por exemplo, "Gerador"
console.log(`Estratégia: ${hd.strategy}`); // por exemplo, "Responder"
console.log(`Autoridade: ${hd.authority}`); // por exemplo, "Sacral"
console.log(`Perfil: ${hd.profile}`);   // por exemplo, "1/3"
console.log(`Canais definidos: ${hd.channels.length}`);

A forma da resposta:

{
  "type": "Gerador",
  "strategy": "Responder",
  "notSelfTheme": "Frustração",
  "authority": "Sacral",
  "profile": "1/3",
  "definition": "único",
  "cross": {
    "name": "Cruz do Ângulo Direito do Esfinge",
    "quarter": "Civilização",
    "gates": [1, 2, 7, 13]
  },
  "centers": [
    { "name": "Sacral", "defined": true },
    ...
  ],
  "channels": [
    { "gate1": 34, "gate2": 20, "name": "Canal do Carisma", "type": "Gerado" }
  ],
  "personalityActivations": [...],
  "designActivations": [...]
}

A Penta é uma técnica para entender a dinâmica da equipe em grupos de 3-5 pessoas. É uma raridade — a maioria dos calculadores de Design Humano não a oferece. Mas é ouro para plataformas de RH, coaching e desenvolvimento de equipes.

const penta = await client.hdPenta({
  members: [
    { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    { date: '1988-03-10', time: '08:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
    { date: '1985-11-22', time: '18:00:00', timezoneOffset: -5, latitude: 40.71, longitude: -74.00 },
  ],
});

console.log(`Tipo de Penta: ${penta.type}`);
console.log(`Canais definidos no grupo: ${penta.definedChannels.length}`);

Os mapas do Design Humano são sensíveis ao tempo de nascimento. Um erro de 10 minutos pode alterar o Perfil (por exemplo, 1/3 → 1/4). Para usuários que não conhecem o tempo exato, execute a análise de sensibilidade:

const sensitivity = await client.hdSensitivity({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

// sensitivity mostrará quais campos mudarão com o deslocamento do tempo em ±5/15/30 minutos

Use isso para alertar o usuário: “Nesta precisão, seu perfil pode mudar. Considere a retificação”.

Se você está construindo um aplicativo focado em Design Humano:

• Usuário básico: 1 mapa do Design Humano ao se registrar, armazenado em cache para sempre = 50 créditos, uma vez
• Usuário ativo: trânsitos periódicos + compatibilidade = ~200 créditos/mês
• 100 DAU com uso moderado de Design Humano: ~110 000 créditos/mês → Starter ($19/mês) cobre facilmente
• 1 000 DAU: ~150 000 créditos/mês → Pro ($59/mês)

Os pedidos de compatibilidade são os mais caros (100 créditos). Armazene em cache os resultados para cada par de usuários para sempre (eles são imutáveis).

A renderização do bodygraph é tradicionalmente feita por meio de SVG. A API retorna os dados dos centros e canais; você renderiza a visualização. Exemplo:

function Bodygraph({ hd }: { hd: HDChart }) {
  return (
    <svg viewBox="0 0 400 600">
      {hd.centers.map(c => (
        <polygon
          key={c.name}
          points={CENTER_COORDS[c.name]}
          fill={c.defined ? CENTER_COLORS[c.name] : 'white'}
          stroke="black"
        />
      ))}
      {hd.channels.map(ch => (
        <line
          key={`${ch.gate1}-${ch.gate2}`}
          x1={GATE_COORDS[ch.gate1].x}
          y1={GATE_COORDS[ch.gate1].y}
          x2={GATE_COORDS[ch.gate2].x}
          y2={GATE_COORDS[ch.gate2].y}
          stroke="#d4a84c"
          strokeWidth="3"
        />
      ))}
    </svg>
  );
}

As coordenadas são um padrão fixo (cada bodygraph tem os mesmos 9 centros e 64 portas nas mesmas posições).

• API de Design Humano — página do produto com a lista completa de endpoints
• Exemplo: Design Humano — walkthrough detalhado do /v1/human-design
• Guia de início rápido — obtenha uma chave de API gratuita (até 200 mapas de Design Humano/mês no plano Free)