API Human Design: construiți aplicații HD pe 12 endpoint-uri

🕓 Înregistrare din 2026-04-14, actualizat 2026-05-09. SDK-urile TS / Python / PHP sunt acum disponibile pe registrele publice - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Detalii în changelog.

Human Design a evoluat de la un sistem ezoteric de nișă din anii 1990 la un cadru mainstream de dezvoltare personală. Aplicațiile cu milioane de utilizatori l-au normalizat - iar dezvoltatorii pun întrebarea: cum calculezi o hartă Human Design programatic?

În acest articol - partea tehnică: ce este calculul HD, ce API-uri îl suportă și cum să integrezi funcționalitatea HD în aplicația ta.

Human Design se bazează pe trei sisteme clasice:

• Astrologia occidentală - pozițiile planetelor la momentul nașterii
• I Ching - 64 de hexagrame, mapate pe 64 „porți”
• Sistemul chakrelor - nouă „centre” (noduri energetice)

Calculul folosește datele de naștere și generează un bodygraph - o hartă vizuală cu:

• Tipul (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - semnătura energetică
• Strategia - cum să iei decizii
• Autoritatea - cărui centru să îi acorzi încredere în luarea deciziilor (Sacral, Emotional, Splenic etc.)
• Profilul - combinație de linii (1/3, 4/6 etc.)
• Canalele - conexiuni între centre care formează personalitatea
• Crucea Incarnării - scopul vieții, derivat din patru poziții cheie

Sub capotă, fiecare dintre cele 64 de porți corespunde unui interval de longitudine ecliptică. Longitudinea planetelor tale la naștere este mapată pe porți specifice (și rândurile din interiorul acestora). Calculul „Design” folosește o deplasare a Soarelui cu 88° înainte de naștere - aproximativ 3 luni mai devreme.

Human Design folosește două momente de naștere:

1. Personality - momentul real al nașterii. Aceasta este partea „conștientă”.
2. Design - momentul în care Soarele era cu 88° înaintea poziției de naștere. Aceasta este partea „inconștientă”.

Fiecare activare a unei porți aparține uneia dintre cele două. O hartă completă are 13 + 13 = 26 de activări.

Acesta este motivul pentru care calculul HD este mai complex decât o hartă astrologică standard - calculezi efectiv două hărți.

Majoritatea API-urilor de astrologie nu suportă deloc HD sau au suport superficial (doar tip + strategie). O implementare completă a HD necesită:

• Maparea celor 64 de porți (tabel de căutare)
• 6 linii pentru fiecare poartă (384 de celule)
• 9 centre cu logica defined/open
• 36 de canale (fiecare conectează două centre)
• Calculul Crucii Incarnării
• Generarea Profilului din linia porții Soarelui + linia porții Pământului (Personality și Design)

API-urile care suportă toate acestea sunt extrem de rare. AstroWay API oferă 12 endpoint-uri HD - cea mai profundă acoperire pe care am văzut-o într-un API comercial.

Imaginează-ți că adaugi HD într-o aplicație astrologică existentă. Începe cu endpoint-ul 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}`);

Răspunsul va arăta astfel:

{
  "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 este o tehnică pentru înțelegerea dinamicii unei echipe de 3–5 persoane. Este rar întâlnită - majoritatea calculatoarelor HD nu o oferă. Dar este o comoară pentru aplicațiile HR-tech, platformele de coaching și cele de team building.

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

Hărțile HD sunt sensibile la ora nașterii. O eroare de 10 minute poate schimba Profilul (de exemplu, 1/3 → 1/4). Pentru utilizatorii care nu cunosc ora exactă, rulează o analiză de sensibilitate:

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 хв

Folosește acest lucru pentru a-i avertiza pe utilizatori: „La această precizie, profilul tău poate fi afectat. Ia în considerare rectificarea.”

Dacă construiești o aplicație focusată pe HD:

• Utilizator de bază: 1 hartă HD la înregistrare, memorată pe termen nelimitat = 50 de credite o singură dată
• Utilizator activ: tranzite periodice + compatibilitate = ~200 de credite/lună
• 100 de utilizatori activi zilnic cu utilizare moderată HD: ~110.000 de credite/lună → Starter ($19/lună) acoperă ușor
• 1.000 de utilizatori activi zilnic: ~150.000 de credite/lună → Pro ($59/lună)

Cererea de compatibilitate este cea mai costisitoare (100 de credite). Memorează rezultatele pentru fiecare pereche de utilizatori pe termen nelimitat (sunt neschimbate).

Rendarea bodygraph-ului se face în mod tradițional prin SVG. API-ul returnează date despre centre și canale; tu le redai vizual. Exemplu:

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

Coordonatele sunt un șablon fix (fiecare bodygraph are aceiași 9 centre și 64 de porți în aceleași poziții).

• Human Design API - pagina de produs cu lista completă de endpoint-uri
• Exemplu: Human Design - un ghid detaliat pentru /v1/human-design
• Start rapid - obține o cheie API gratuită (până la 200 de hărți HD/lună în planul Free)