Human Design API: buduj aplikacje HD na 12 endpointach

🕓 Wpis z dnia 2026-04-14, zaktualizowany 2026-05-09. TS / Python / PHP SDK są teraz dostępne w publicznych rejestrach — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Szczegóły w changelog.

Human Design ewoluował z niszowego systemu ezoterycznego z lat 90. do ramy rozwoju osobistego w mainstreamie. Aplikacje z milionami użytkowników go unormowały — i deweloperzy zadają pytanie: jak obliczyć kartę Human Design programowo?

W tym poście — techniczna strona: co to jest obliczanie HD, które API je obsługują i jak wdrożyć funkcjonalność HD w swojej aplikacji.

Human Design oparty jest na trzech klasycznych systemach:

• Zachodnia astrologia — pozycje planet w momencie urodzenia
• I Ching — 64 heksagramy, zamapowane na 64 “bramy”
• System czakr — dziewięć “centrów” (węzłów energetycznych)

Obliczanie bierze dane urodzenia i zwraca bodygraph — wizualną mapę z:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — sygnatura energetyczna
• Strategy — jak podejmować decyzje
• Authority — któremu centrum ufać przy decyzjach (Sacral, Emotional, Splenic itd.)
• Profile — kombinacja linii (1/3, 4/6 itd.)
• Channels — połączenia między centrami, które kształtują osobowość
• Incarnation Cross — przeznaczenie życia, pochodne od czterech kluczowych pozycji

Pod maską każda z 64 bram odpowiada zakresowi długości ekliptycznej. Długość twoich planet przy urodzeniu mapowana jest na konkretne bramy (i wiersze wewnątrz nich). Obliczanie “Design” — dla przesunięcia Słońca o 88° do urodzenia — około 3 miesiące wcześniej.

Human Design wykorzystuje dwie daty urodzenia:

1. Personality — rzeczywisty czas urodzenia. To “świadomy” bok.
2. Design — kiedy Słońce było na 88° do pozycji urodzenia. To “nieswiadomy” bok.

Każda aktywacja bram należy do jednego z nich. Pełna karta ma 13 + 13 = 26 aktywacji.

To właśnie sprawia, że obliczanie HD jest trudniejsze niż standardowa karta astrologiczna — tak naprawdę liczy się dwie karty.

Większość API astrologicznych albo w ogóle nie obsługuje HD, albo ma powierzchowną obsługę (tylko type + strategy). Pełna implementacja HD wymaga:

• Mapowania 64 bram (tabela wyszukiwania)
• 6 linii na każdą bramę (384 komórki)
• 9 centrów z logiką defined/open
• 36 kanałów (każdy łączy dwa centra)
• Obliczanie Incarnation Cross
• Wyprowadzanie Profile z linii bramy Słońca + linii bramy Ziemi (Personality i Design)

API, które potrafią to wszystko, są rzadkością. AstroWay API ma 12 punktów końcowych HD — najgłębsze pokrycie, jakie widzieliśmy w komercyjnym API.

Wyobraź sobie, że dodajesz HD do już istniejącej aplikacji astrologicznej. Zaczynaj od głównego punktu końcowego:

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

Forma odpowiedzi:

{
  "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 — technika zrozumienia dynamiki zespołu w grupach 3–5 osób. To rzadkość — większość kalkulatorów HD nie oferuje jej. Ale to jest złoto dla HR-tech, platform coachingowych i aplikacji teambuildingowych.

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 type: ${penta.type}`);
console.log(`Defined channels in group: ${penta.definedChannels.length}`);

Karty HD są wrażliwe na czas urodzenia. Błąd 10 minut może zmienić Profile (np. 1/3 → 1/4). Dla użytkowników, którzy nie znają dokładnego czasu, uruchom analizę wrażliwości:

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

// sensitivity pokaże, które pola zmienią się przy przesunięciu czasu o ±5/15/30 min

Użyj tego, aby ostrzec użytkownika: «Na tej dokładności twój profil może się przesunąć. Rozważ rektyfikację».

Jeśli budujesz aplikację HD-focused:

• Podstawowy użytkownik: 1 karta HD przy rejestracji, zbuforowana na zawsze = 50 kredytów jednorazowo
• Aktywny użytkownik: okresowe transity + compatibility = ~200 kredytów/mies
• 100 DAU z umiarkowanym użyciem HD: ~110 000 kredytów/mies → Starter ($19/mies) łatwo pokrywa
• 1 000 DAU: ~150 000 kredytów/mies → Pro ($59/mies)

Zapytania o compatibility są najtrudniejsze (100 kredytów). Buforuj wyniki dla każdej pary użytkowników na zawsze (one są niezmienne).

Renderowanie bodygraphu tradycyjnie odbywa się za pomocą SVG. API zwraca dane o centrach i kanałach; ty renderujesz wizual. Przykład:

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

Współrzędne — stały szablon (każdy bodygraph ma te same 9 centrów i 64 bramy na tych samych pozycjach).

• Human Design API — strona produktowa z pełną listą punktów końcowych
• Przykład: Human Design — szczegółowy przewodnik po /v1/human-design
• Szybki start — otrzymaj bezpłatny klucz API (do 200 kart HD/mies na Free)