Human Design API: stav HD aplikace na 12 endpointech

🕓 Článek z 2026-04-14, aktualizováno 2026-05-09. TS / Python / PHP SDK jsou teď na veřejných registrech - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Podrobnosti v changelogu.

Human Design vyrostl z okrajového esoterického systému 90. let v mainstreamový rámec osobního rozvoje. Aplikace s miliony uživatelů z něj udělaly běžnou věc a vývojáři se ptají: jak spočítat Human Design mapu programově?

Tento článek se věnuje technické stránce: co jsou HD výpočty, která API je podporují a jak zabudovat HD funkci do tvé aplikace.

Human Design stojí na třech klasických systémech:

• Západní astrologie: pozice planet v okamžiku narození
• I Ching: 64 hexagramů namapovaných na 64 “bran”
• Čakrový systém: devět “center” (energetických uzlů)

Výpočet vezme údaje o narození a vrátí bodygraph, vizuální mapu s těmito prvky:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - energetický podpis
• Strategy: jak se rozhodovat
• Authority: kterému centru při rozhodování důvěřovat (Sacral, Emotional, Splenic atd.)
• Profile: kombinace linií (1/3, 4/6 atd.)
• Channels: spojení mezi centry, která utvářejí osobnost
• Incarnation Cross: životní účel odvozený ze čtyř klíčových pozic

Pod kapotou odpovídá každá z 64 bran rozsahu ekliptikální délky. Délka tvých planet při narození se mapuje na konkrétní brány (a linie uvnitř nich). Výpočet “Design” se dělá pro okamžik, kdy bylo Slunce o 88° zpět před narozením, tedy zhruba 3 měsíce dříve.

Human Design používá dva body narození:

1. Personality: skutečný čas narození. To je “vědomá” stránka.
2. Design: kdy bylo Slunce 88° před pozicí při narození. To je “nevědomá” stránka.

Každá aktivace brány patří k jedné z nich. Kompletní mapa má 13 + 13 = 26 aktivací.

Právě proto je HD výpočet náročnější než standardní astrologická mapa: ve skutečnosti počítáš dvě mapy.

Většina astrologických API buď HD vůbec nepodporuje, nebo jen povrchně (pouze type + strategy). Úplná implementace HD vyžaduje:

• Mapování 64 bran (lookup table)
• 6 linií pro každou bránu (384 buněk)
• 9 center s logikou defined/open
• 36 kanálů (každý spojuje dvě centra)
• Výpočet Incarnation Cross
• Odvození Profile z linie brány Slunce + linie brány Země (Personality i Design)

API, která tohle všechno umějí, jsou velkou vzácností. AstroWay API má 12 HD endpointů, nejhlubší pokrytí, jaké jsme u komerčního API viděli.

Představ si, že přidáváš HD do existující astrologické aplikace. Začni hlavním endpointem:

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}`);         // e.g. "Generator"
console.log(`Strategy: ${hd.strategy}`); // e.g. "To Respond"
console.log(`Authority: ${hd.authority}`); // e.g. "Sacral"
console.log(`Profile: ${hd.profile.profile}`);   // e.g. "1/3"
console.log(`Defined channels: ${hd.channels.length}`);

Tvar odpovědi:

{
  "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": [...]
}

Penta je technika pro pochopení týmové dynamiky ve skupinách 3–5 osob. Je to vzácnost, většina HD kalkulaček ji nenabízí. Pro HR-tech, koučovací platformy a teambuildingové aplikace je to ale zlatý důl.

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}`);

HD mapy jsou citlivé na čas narození. Chyba 10 minut může změnit Profile (například 1/3 → 1/4). U uživatelů, kteří neznají přesný čas, spouštěj analýzu sensitivity:

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

// sensitivity tells you which fields change if time shifts ±5/15/30 min

Použij to k upozornění uživatele: “Při této přesnosti se tvůj profile může posunout. Zvaž rektifikaci.”

Pokud stavíš aplikaci zaměřenou na HD:

• Základní uživatel: 1 HD mapa při registraci, cachovaná navždy = jednorázově 50 kreditů
• Aktivní uživatel: pravidelné tranzity + compatibility = ~200 kreditů/měs.
• 100 DAU s mírným využitím HD: ~110 000 kreditů/měs. → Starter ($19/měs.) to snadno pokryje
• 1 000 DAU: ~150 000 kreditů/měs. → Pro ($59/měs.)

Požadavky na compatibility jsou nejtěžší (100 kreditů). Výsledky pro každou dvojici uživatelů cachuj navždy (nemění se).

Bodygraph se tradičně renderuje přes SVG. API vrací data o centrech a kanálech, vizuál renderuješ ty. Příklad:

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>
  );
}

Souřadnice jsou pevná šablona (každý bodygraph má stejných 9 center a 64 bran na stejných pozicích).

• Human Design API: produktová stránka s úplným seznamem endpointů
• Příklad: Human Design: podrobný walkthrough /v1/human-design
• Rychlý start: získej bezplatný API klíč (až 200 HD map/měs. na Free)