Human Design API: HD-Apps auf 12 Endpunkten bauen

🕓 Beitrag vom 2026-04-14, aktualisiert am 2026-05-09. Die TS-, Python- und PHP-SDKs liegen jetzt in öffentlichen Registries - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Details im Changelog.

Human Design ist aus einem esoterischen Nischensystem der 1990er zu einem gängigen Rahmen für persönliche Entwicklung geworden. Apps mit Millionen Nutzern haben es normalisiert, und Entwickler fragen sich: Wie berechnet man ein Human-Design-Chart programmatisch?

In diesem Beitrag geht es um die technische Seite: was eine HD-Berechnung ist, welche APIs sie unterstützen und wie du ein HD-Feature in deine App einbaust.

Human Design baut auf drei klassischen Systemen auf:

• Westliche Astrologie: die Planetenpositionen zum Zeitpunkt der Geburt
• I Ging: 64 Hexagramme, abgebildet auf 64 “Tore”
• Chakrensystem: neun “Zentren” (energetische Knotenpunkte)

Die Berechnung nimmt die Geburtsdaten und erzeugt einen Bodygraph - eine visuelle Karte mit:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector): die energetische Signatur
• Strategy: wie Entscheidungen getroffen werden
• Authority: welchem Zentrum man bei Entscheidungen vertraut (Sacral, Emotional, Splenic usw.)
• Profile: eine Kombination von Linien (1/3, 4/6 usw.)
• Channels: Verbindungen zwischen Zentren, die die Persönlichkeit prägen
• Incarnation Cross: die Lebensaufgabe, abgeleitet aus vier Schlüsselpositionen

Technisch entspricht jedes der 64 Tore einem Bereich der ekliptikalen Länge. Die Längen deiner Planeten bei der Geburt werden auf konkrete Tore (und die Linien darin) abgebildet. Die “Design”-Berechnung verwendet den Zeitpunkt, an dem die Sonne 88° vor ihrer Geburtsposition stand, also etwa 3 Monate vor der Geburt.

Human Design verwendet zwei Zeitpunkte:

1. Personality: die tatsächliche Geburtszeit. Das ist die “bewusste” Seite.
2. Design: der Moment, als die Sonne 88° vor ihrer Geburtsposition stand. Das ist die “unbewusste” Seite.

Jede Tor-Aktivierung gehört zu einer der beiden. Ein vollständiges Chart hat 13 + 13 = 26 Aktivierungen.

Genau das macht die HD-Berechnung aufwendiger als ein normales astrologisches Chart: Du berechnest faktisch zwei Charts.

Die meisten Astrologie-APIs unterstützen HD entweder gar nicht oder nur oberflächlich (nur Type + Strategy). Eine vollständige HD-Implementierung braucht:

• Die Zuordnung der 64 Tore (Lookup-Tabelle)
• 6 Linien pro Tor (384 Felder)
• 9 Zentren mit defined/open-Logik
• 36 Kanäle (jeder verbindet zwei Zentren)
• Die Berechnung des Incarnation Cross
• Die Ableitung des Profile aus der Torlinie der Sonne + der Torlinie der Erde (Personality und Design)

APIs, die all das können, sind sehr selten. Die AstroWay API hat 12 HD-Endpunkte - die tiefste Abdeckung, die wir bei einer kommerziellen API gesehen haben.

Angenommen, du ergänzt eine bestehende Astrologie-App um HD. Fang mit dem Hauptendpunkt an:

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

Die Form der Antwort:

{
  "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 ist eine Methode, um die Teamdynamik in Gruppen von 3–5 Personen zu verstehen. Sie ist selten, die meisten HD-Rechner bieten sie nicht an. Für HR-Tech, Coaching-Plattformen und Teambuilding-Apps ist sie aber Gold wert.

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

HD-Charts reagieren empfindlich auf die Geburtszeit. Ein Fehler von 10 Minuten kann das Profile ändern (zum Beispiel 1/3 → 1/4). Für Nutzer, die ihre genaue Geburtszeit nicht kennen, führst du eine Sensitivity-Analyse durch:

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

Nutze das, um den Nutzer zu warnen: “Bei dieser Genauigkeit kann sich dein Profile verschieben. Denk über eine Rektifikation nach.”

Wenn du eine HD-fokussierte App baust:

• Einfacher Nutzer: 1 HD-Chart bei der Registrierung, dauerhaft gecacht = 50 Credits einmalig
• Aktiver Nutzer: regelmäßige Transite + Compatibility = ~200 Credits/Monat
• 100 DAU mit moderater HD-Nutzung: ~110 000 Credits/Monat → Starter ($19/Monat) reicht locker
• 1 000 DAU: ~150 000 Credits/Monat → Pro ($59/Monat)

Compatibility-Anfragen sind die teuersten (100 Credits). Cache die Ergebnisse für jedes Nutzerpaar dauerhaft (sie ändern sich nie).

Der Bodygraph wird traditionell als SVG gerendert. Die API liefert die Daten zu Zentren und Kanälen, die Darstellung renderst du selbst. Ein Beispiel:

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

Die Koordinaten sind eine feste Vorlage (jeder Bodygraph hat dieselben 9 Zentren und 64 Tore an denselben Positionen).

• Human Design API: Produktseite mit der vollständigen Liste der Endpunkte
• Beispiel: Human Design: ausführlicher Walkthrough zu /v1/human-design
• Schnellstart: hol dir einen kostenlosen API-Key (bis zu 200 HD-Charts/Monat im Free-Tarif)