Human Design API: építsen HD-alkalmazásokat 12 végponttal

🕓 Bejegyzés 2026-04-14, frissítve 2026-05-09. A TS / Python / PHP SDK-k most a nyilvános regisztereken találhatók — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). További részletek a változások naplójában.

A Human Design a 1990-es évek nisch ezo­terikus rendszereiből kinőve mára mainstream személyiségfejlesztési keretrendszerré vált. Milliók használják nap mint nap, és a fejlesztőknek is felmerül a kérdés: hogyan lehet programozottan kiszámítani egy Human Design-térképet?

Ebben a bejegyzésben a technikai részre koncentrálunk: mi is az a HD-számítás, mely API-k támogatják, és hogyan építheted be a HD-funkciót a saját alkalmazásodba.

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

• Nyugati asztrológia — a bolygók pozíciói a születés időpontjában
• I Ching — 64 hexagramma, amelyek a 64 „kapuhoz” vannak hozzárendelve
• Csakraszisztéma — kilenc „centrum” (energetikai csomópont)

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

• Típus (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — az energiasignatúra
• Stratégia — hogyan kell döntéseket hozni
• Autorítás — melyik centrumra kell hallgatni döntéshozatalkor (Sacral, Emotional, Splenic stb.)
• Profil — vonalak kombinációja (1/3, 4/6 stb.)
• Csatornák — a centrumok közötti kapcsolatok, amelyek meghatározzák a személyiséget
• Reinkarnációs kereszt — az élet célja, négy kulcsfontosságú pozícióból kiindulva

A motor háttérben minden egyes kapu egy ekliptikai hosszúsági tartománynak felel meg. A születéskori bolygóidőpontodat konkrét kapukra (és azok soraira) képezi le. A „Design”-számítás a Nap 88°-os eltolásával történik a születés előtt — ez nagyjából 3 hónappal korábban van.

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

1. Personality — a tényleges születési idő. Ez a „tudatos” oldal.
2. Design — amikor a Nap 88°-kal a születési pozíció előtt volt. Ez a „tudattalan” oldal.

Minden kapuaktiváció az egyikhez tartozik. A teljes térkép 13 + 13 = 26 aktivációt tartalmaz.

Ez teszi a HD-számítást nehezebbé a standard asztrológiai térképnél — valójában két térképet kell kiszámítanod.

A legtöbb asztrológiai API vagy egyáltalán nem támogatja a HD-t, vagy csak felületesen (csak típus + stratégia). A teljes HD-implementációhoz szükséges:

• A 64 kapu leképezése (lookup tábla)
• 6 vonal minden kapura (384 cella)
• 9 centrum a defined/open logikával
• 36 csatorna (minden két centrumot köt össze)
• A Reinkarnációs kereszt kiszámítása
• A Profil kiírása a Nap kapujának vonalából + a Föld kapujának vonalából (Personality és Design)

Azok az API-k, amelyek mindent tudnak, nagyon ritkák. Az AstroWay API 12 HD-endpointtal rendelkezik — a legmélyebb lefedettséget, amit valaha láttunk kereskedelmi API-kban.

Képzeld el, hogy egy már működő asztrológiai alkalmazásodhoz adod hozzá a HD-t. Kezdd a fő endpointtal:

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(`Típus: ${hd.type}`);         // például "Generator"
console.log(`Stratégia: ${hd.strategy}`); // például "To Respond"
console.log(`Autorítás: ${hd.authority}`); // például "Sacral"
console.log(`Profil: ${hd.profile}`);   // például "1/3"
console.log(`Meghatározott csatornák: ${hd.channels.length}`);

Válasz formátum:

{
  "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 egy technika a csapatdinamika megértésére 3–5 fős csoportokban. Ez ritkaság — a legtöbb HD-kalkulátor nem kínálja fel. De ez aranyat ér az HR-tech, coaching-platformok és team-building alkalmazások számára.

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(`Penta típus: ${penta.type}`);
console.log(`Meghatározott csatornák a csoportban: ${penta.definedChannels.length}`);

A HD-térképek érzékenyek a születési időpontra. 10 perces hiba is megváltoztathatja a Profilt (például 1/3 → 1/4). Azoknak a felhasználóknak, akik nem ismerik a pontos időt, futtasd le az érzékenység-analízist:

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

// A sensitivity megmutatja, mely mezők változnak meg ±5/15/30 perces időeltolódás esetén

Használd ezt, hogy figyelmeztesd a felhasználót: „Ezen a pontossági szinten a profilod elmozdulhat. Fontold meg a rectifikációt.”

Ha HD-fókuszú alkalmazást építesz:

• Alap felhasználó: 1 HD-térkép regisztrációkor, örökre cache-elve = 50 kredit egyszeri díj
• Aktív felhasználó: időszakos tranzitok + kompatibilitás = ~200 kredit/hó
• 100 DAU mérsékelt HD-használattal: ~110 000 kredit/hó → a Starter ($19/hó) könnyen fedezi
• 1 000 DAU: ~150 000 kredit/hó → Pro ($59/hó)

A kompatibilitási lekérdezések a legdrágábbak (100 kredit). Cache-eld az eredményeket minden felhasználói pár számára örökre (ezek nem változnak).

A bodygraph renderelése hagyományosan SVG-n keresztül történik. Az API visszaadja a centrumok és csatornák adatait; te renderelteted a vizuált. 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 rögzített sablonok (minden bodygraph ugyanazokon a pozíciókon tartalmazza a 9 centrumot és a 64 kaput).

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