Human Design API: HD-Apps auf 12 Endpunkten aufbauen

🕓 Eintrag vom 2026-04-14, aktualisiert am 2026-05-09. TS / Python / PHP SDK leben jetzt in öffentlichen Registries — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Details im Changelog.

Human Design ist von einem Nischen-ESO-System der 1990er Jahre zu einem Mainstream-Rahmen für persönliche Entwicklung gewachsen. Apps mit Millionen von Nutzern haben es normalisiert - und Entwickler stellen Fragen: Wie berechnet man die Human-Design-Karte programmatisch?

In diesem Beitrag geht es um die technische Seite: Was sind HD-Berechnungen, welche APIs unterstützen sie und wie integrierst du die HD-Funktion in deine App.

Human Design basiert auf drei klassischen Systemen:

• Westliche Astrologie — Planetenpositionen im Moment der Geburt
• I Ching — 64 Hexagramme, die auf 64 “Tore” abgebildet sind
• Chakrasystem — neun “Zentren” (energetische Knoten)

Die Berechnung nimmt die Geburtsdaten und gibt einen Bodygraph aus — eine visuelle Karte mit:

• Typ (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — energetische Signatur
• Strategie — wie Entscheidungen getroffen werden
• Autorität — welchem Zentrum bei Entscheidungen vertraut werden soll (Sacral, Emotional, Splenic usw.)
• Profil — Kombination von Linien (1/3, 4/6 usw.)
• Kanäle — Verbindungen zwischen Zentren, die die Persönlichkeit formen
• Inkarnationskreuz — Lebensaufgabe, abgeleitet von vier Schlüsselpositionen

Unter der Haube entspricht jedes der 64 Tore einem Bereich der ekliptischen Länge. Die Länge deiner Planeten bei der Geburt wird auf bestimmte Tore (und Reihen innerhalb davon) abgebildet. Die Berechnung des “Designs” — für die Verschiebung der Sonne um 88° vor der Geburt — etwa 3 Monate früher.

Human Design verwendet zwei Geburtszeitpunkte:

1. Persönlichkeit — die tatsächliche Geburtszeit. Dies ist die “bewusste” Seite.
2. Design — wenn die Sonne 88° von der Geburtsposition entfernt war. Dies ist die “unbewusste” Seite.

Jede Aktivierung der Tore gehört zu einem von ihnen. Die vollständige Karte hat 13 + 13 = 26 Aktivierungen.

Genau das macht die HD-Berechnung schwieriger als eine Standard-Astrologiekarte — du berechnest tatsächlich zwei Karten.

Die meisten Astrologie-APIs unterstützen HD entweder gar nicht oder haben eine oberflächliche Unterstützung (nur Typ + Strategie). Eine vollständige HD-Implementierung erfordert:

• Eine Abbildung der 64 Tore (Lookup-Tabelle)
• 6 Linien pro Tor (384 Zellen)
• 9 Zentren mit Defined/Open-Logik
• 36 Kanäle (jeder verbindet zwei Zentren)
• Inkarnationskreuz-Berechnung
• Profil-Ausgabe aus Sonnen- und Erdtor-Linien (Persönlichkeit und Design)

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

Stell dir vor, du fügst HD in eine bereits bestehende Astrologie-App hinzu. Beginne mit dem Hauptendpunkt:

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(`Typ: ${hd.type}`);         // z.B. "Generator"
console.log(`Strategie: ${hd.strategy}`); // z.B. "To Respond"
console.log(`Autorität: ${hd.authority}`); // z.B. "Sacral"
console.log(`Profil: ${hd.profile}`);   // z.B. "1/3"
console.log(`Definierte Kanäle: ${hd.channels.length}`);

Die Antwortform:

{
  "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 Technik, um die Dynamik eines Teams in Gruppen von 3–5 Personen zu verstehen. Dies ist eine Seltenheit — die meisten HD-Rechner bieten es nicht an. Aber es ist Gold für HR-Tech, Coaching-Plattformen und Team-Building-Apps.

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-Typ: ${penta.type}`);
console.log(`Definierte Kanäle in der Gruppe: ${penta.definedChannels.length}`);

HD-Karten sind empfindlich gegenüber der Geburtszeit. Ein Fehler von 10 Minuten kann das Profil ändern (z.B. 1/3 → 1/4). Für Benutzer, die die genaue Geburtszeit nicht kennen, starte eine Sensitivity-Analyse:

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

// sensitivity zeigt, welche Felder sich ändern, wenn die Zeit um ±5/15/30 Minuten verschoben wird

Verwende dies, um den Benutzer zu warnen: “Bei dieser Genauigkeit kann dein Profil sich ändern. Berücksichtige eine Rektifizierung”.

Wenn du eine HD-fokussierte Anwendung baust:

• Basisbenutzer: 1 HD-Karte bei der Registrierung, gecacht für immer = 50 Kredite einmalig
• Aktiver Benutzer: periodische Transite + Kompatibilität = ~200 Kredite/Monat
• 100 DAU mit moderater HD-Nutzung: ~110 000 Kredite/Monat → Starter ($19/Monat) deckt es leicht ab
• 1 000 DAU: ~150 000 Kredite/Monat → Pro ($59/Monat)

Kompatibilitätsanfragen sind die teuersten (100 Kredite). Cachiere die Ergebnisse für jedes Benutzerpaar für immer (sie sind unveränderlich).

Die Darstellung des Bodygraphs wird traditionell durch SVG durchgeführt. Die API gibt die Daten zu den Zentren und Kanälen zurück; du renderst die Visualisierung. 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 ein fester Muster (jeder Bodygraph hat dieselben 9 Zentren und 64 Tore an denselben Positionen).

• Human Design API — Produktseite mit vollständiger Liste der Endpunkte
• Beispiel: Human Design — detaillierter Walkthrough /v1/human-design
• Schnellstart — erhält einen kostenlosen API-Schlüssel (bis zu 200 HD-Karten/Monat auf Free)