Human Design API: HD-alkalmazások 12 végpontra építve

🕓 Bejegyzés: 2026-04-14, frissítve: 2026-05-09. A TS / Python / PHP SDK-k már a nyilvános registrykben élnek - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Részletek a changelogban.

A Human Design az 1990-es évek szűk ezoterikus rendszeréből a személyes fejlődés egyik mainstream keretrendszerévé nőtte ki magát. A több millió felhasználós alkalmazások normalizálták, és a fejlesztők felteszik a kérdést: hogyan lehet programból kiszámolni egy Human Design-térképet?

Ebben a bejegyzésben a technikai oldalról lesz szó: mi a HD-számítás, mely API-k támogatják, és hogyan építhetsz HD-funkciót a saját alkalmazásodba.

A Human Design három klasszikus rendszerre épül:

• Nyugati asztrológia: a bolygók helyzete a születés pillanatában
• I Ching: 64 hexagram, a 64 “kapura” leképezve
• Csakrarendszer: kilenc “centrum” (energetikai csomópont)

A számítás a születési adatokból egy bodygraph-ot állít elő, egy vizuális térképet, amely tartalmazza:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector): az energetikai szignatúra
• Strategy: hogyan hozz döntéseket
• Authority: melyik centrumra hagyatkozz döntéskor (Sacral, Emotional, Splenic stb.)
• Profile: a vonalak kombinációja (1/3, 4/6 stb.)
• Channels: a centrumok közötti kapcsolatok, amelyek a személyiséget formálják
• Incarnation Cross: az életcél, négy kulcspozícióból levezetve

A háttérben mind a 64 kapu egy ekliptikai hosszúsági tartománynak felel meg. A bolygóid születéskori hosszúsága konkrét kapukra (és azokon belül vonalakra) képeződik le. A “Design” számítása a Nap születés előtti 88°-os visszalépésére vonatkozik, ez nagyjából 3 hónappal korábbi időpont.

A Human Design két születési pontot használ:

1. Personality: a valós születési idő. Ez a “tudatos” oldal.
2. Design: amikor a Nap 88°-kal a születési pozíció előtt járt. Ez a “tudattalan” oldal.

Minden kapuaktiváció a kettő közül valamelyikhez tartozik. A teljes térkép 13 + 13 = 26 aktivációt tartalmaz.

Épp ettől nehezebb a HD-számítás egy szokásos asztrológiai képletnél: gyakorlatilag két térképet számolsz.

A legtöbb asztrológiai API vagy egyáltalán nem támogatja a HD-t, vagy csak felületesen (csak type + strategy). A teljes HD-implementációhoz kell:

• A 64 kapu leképezése (lookup table)
• Kapunként 6 vonal (384 cella)
• 9 centrum defined/open logikával
• 36 csatorna (mindegyik két centrumot köt össze)
• Az Incarnation Cross kiszámítása
• A Profile levezetése a Nap kapujának vonalából + a Föld kapujának vonalából (Personality és Design)

Az ezt mind tudó API-k nagyon ritkák. Az AstroWay API 12 HD-végpontot kínál, ez a legmélyebb lefedettség, amit kereskedelmi API-ban láttunk.

Tegyük fel, hogy egy meglévő asztrológiai alkalmazásba építed be a HD-t. Kezdd a fő végponttal:

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

A válasz formája:

{
  "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 a 3–5 fős csoportok csapatdinamikájának megértésére szolgáló technika. Ritkaság: a legtöbb HD-kalkulátor nem kínálja. A HR-tech, coaching-platformok és csapatépítő alkalmazások számára viszont aranyat ér.

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

A HD-térképek érzékenyek a születési időre. Már 10 perc eltérés megváltoztathatja a Profile-t (például 1/3 → 1/4). Azoknál a felhasználóknál, akik nem tudják a pontos időt, futtass sensitivity-elemzést:

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

Ezzel figyelmeztetheted a felhasználót: “Ennél a pontosságnál a profilod elcsúszhat. Érdemes megfontolni a rektifikációt.”

Ha HD-központú alkalmazást építesz:

• Alap felhasználó: 1 HD-térkép regisztrációkor, örökre gyorsítótárazva = egyszeri 50 kredit
• Aktív felhasználó: időszakos tranzitok + compatibility = ~200 kredit/hó
• 100 DAU mérsékelt HD-használattal: ~110 000 kredit/hó → a Starter ($19/hó) bőven lefedi
• 1 000 DAU: ~150 000 kredit/hó → Pro ($59/hó)

A compatibility-kérések a legnehezebbek (100 kredit). Minden felhasználópár eredményét gyorsítótárazd örökre (nem változnak).

A bodygraph-ot hagyományosan SVG-vel renderelik. Az API a centrumok és csatornák adatait adja vissza, a vizuális részt te rendereled. Példa:

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

A koordináták fix sablont alkotnak (minden bodygraph ugyanazt a 9 centrumot és 64 kaput tartalmazza ugyanazokon a helyeken).

• Human Design API: termékoldal a végpontok teljes listájával
• Példa: Human Design: részletes walkthrough a /v1/human-design végponthoz
• Gyors kezdés: szerezz ingyenes API-kulcsot (Free csomagban akár 200 HD-térkép/hó)