Human Design API: postavte HD-aplikace na 12 endpointech

🕓 Zápis z 2026-04-14, aktualizováno 2026-05-09. TS / Python / PHP SDK nyní žijí na veřejných registrech — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Podrobnosti v changelogu.

Human Design se vyvinul z niszové esoterické soustavy 90. let 20. století do mainstreamového rámce osobního rozvoje. Aplikace s miliony uživatelů jej znormalizovaly — a vývojáři si kladou otázku: jak programově vypočítat Human Design mapu?

V tomto článku se podíváme na technickou stránku: co je to výpočet HD, které API jej podporují a jak integrovat HD funkci do své aplikace.

Human Design je postavený na třech klasických systémech:

• Západní astrologie — pozice planet v okamžiku narození
• I Ching — 64 hexagramy, zmapované na 64 „brány“
• Čakrový systém — devět „center“ (energetických uzlů)

Výpočet bere data narození a vrací bodygraph — vizuální mapu s:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — energetická signatura
• Strategy — jak přijímat rozhodnutí
• Authority — kterému centru důvěřovat při rozhodování (Sacral, Emotional, Splenic atd.)
• Profile — kombinace linií (1/3, 4/6 atd.)
• Channels — propojení mezi centry, která formují osobnost
• Incarnation Cross — životní poslání, odvozené od čtyř klíčových pozic

Pod kapotou každá ze 64 bran odpovídá rozsahu ekliptické délky. Délka tvých planet při narození se mapuje na konkrétní brány (a řádky uvnitř nich). Výpočet „Design“ je posunutí Slunce o 88° před narozením — zhruba o 3 měsíce dříve.

Human Design používá dvě data narození:

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

Každá aktivace bran patří k jednomu z nich. Kompletní mapa má 13 + 13 = 26 aktivací.

Právě to dělá výpočet HD těžším než standardní astrologickou mapu — vlastně počítáš dvě mapy.

Většina astrologických API buď vůbec nepodporují HD, nebo mají povrchní podporu (jen type + strategy). Kompletní implementace HD vyžaduje:

• Mapování 64 bran (lookup tabulka)
• 6 linií na každou bránu (384 buněk)
• 9 center s logikou defined/open
• 36 kanálů (každý propojuje dvě centra)
• Výpočet Incarnation Cross
• Výstup profilu z linie bran Slunce + linie bran Země (Personality a Design)

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

Představ si, že přidáváš HD do již 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({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Typ: ${hd.type}`);         // např. "Generator"
console.log(`Strategie: ${hd.strategy}`); // např. "To Respond"
console.log(`Autorita: ${hd.authority}`); // např. "Sacral"
console.log(`Profil: ${hd.profile}`);   // např. "1/3"
console.log(`Definované kanály: ${hd.channels.length}`);

Formát 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í dynamiky týmu ve skupinách 3–5 osob. Je to vzácnost — většina HD kalkulátorů ji nenabízí. Ale je to poklad pro HR-tech, koučovací platformy a team-building aplikace.

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(`Typ Pentu: ${penta.type}`);
console.log(`Definované kanály ve skupině: ${penta.definedChannels.length}`);

HD mapy jsou citlivé na čas narození. Chyba o 10 minut může změnit profil (např. 1/3 → 1/4). Pro uživatele, kteří neznají přesný čas, spusť analýzu citlivosti:

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

// sensitivity ukáže, která pole se změní při posunu času o ±5/15/30 min

Použij to k varování uživatele: „Při této přesnosti se tvůj profil může posunout. Zvaž rectifikaci.“

Pokud stavíš HD-focused aplikaci:

• Základní uživatel: 1 HD mapa při registraci, uložená navždy = 50 kreditů jednorázově
• Aktivní uživatel: pravidelné transity + kompatibilita = ~200 kreditů/měsíc
• 100 DAU s mírným používáním HD: ~110 000 kreditů/měsíc → Starter ($19/měs) to snadno pokryje
• 1 000 DAU: ~150 000 kreditů/měsíc → Pro ($59/měs)

Kompatibilitní dotazy jsou nejnáročnější (100 kreditů). Cache výsledky pro každou dvojici uživatelů navždy (jsou neměnné).

Renderování bodygraphu se tradičně dělá přes SVG. API vrací data o centrech a kanálech; ty pak renderuješ vizuál. 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ý šablon (každý bodygraph má stejných 9 center a 64 bran na stejných pozicích).

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