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.compute({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Type: ${hd.type}`);         // наприклад, "Generator"
console.log(`Strategy: ${hd.strategy}`); // наприклад, "To Respond"
console.log(`Authority: ${hd.authority}`); // наприклад, "Sacral"
console.log(`Profile: ${hd.profile.profile}`);   // наприклад, "1/3"
console.log(`Defined channels: ${hd.channels.length}`);

A forma da resposta:

{
  "type": "Generator",
  "strategy": "To Respond",
  "notSelfTheme": "Frustration",
  "authority": "Sacral",
  "profile": "1/3",
  "definition": "single",
  "cross": {
    "name": "Right Angle Cross of the Sphinx",
    "quarter": "Civilization",
    "gates": [1, 2, 7, 13]
  },
  "centers": [
    { "name": "Sacral", "defined": true },
    ...
  ],
  "channels": [
    { "gate1": 34, "gate2": 20, "name": "Channel of Charisma", "type": "Generated" }
  ],
  "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.hd.penta({
  inputs: [
    { 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(`Members: ${penta.memberCount}`);
console.log(`Channels in the group: ${penta.channels.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.hd.sensitivity({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

// sensitivity покаже, які поля зміняться при зсуві часу на ±5/15/30 хв

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)