Human Design API: φτιάξε εφαρμογές HD πάνω σε 12 endpoints

🕓 Ανάρτηση της 2026-04-14, ενημερώθηκε 2026-05-09. Τα TS / Python / PHP SDK βρίσκονται πλέον σε δημόσια registries - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Λεπτομέρειες στο changelog.

Το Human Design ξεκίνησε ως εξειδικευμένο εσωτερικό σύστημα της δεκαετίας του 1990 και έγινε mainstream πλαίσιο προσωπικής ανάπτυξης. Εφαρμογές με εκατομμύρια χρήστες το έκαναν κάτι συνηθισμένο, και οι developers ρωτούν πλέον: πώς υπολογίζεται ένας χάρτης Human Design προγραμματιστικά;

Σε αυτή την ανάρτηση βλέπουμε την τεχνική πλευρά: τι είναι οι υπολογισμοί HD, ποια API τους υποστηρίζουν και πώς να ενσωματώσεις μια λειτουργία HD στην εφαρμογή σου.

Το Human Design βασίζεται σε τρία κλασικά συστήματα:

• Δυτική αστρολογία: οι θέσεις των πλανητών τη στιγμή της γέννησης
• I Ching: 64 εξάγραμμα, αντιστοιχισμένα σε 64 “πύλες”
• Σύστημα τσάκρα: εννέα “κέντρα” (ενεργειακοί κόμβοι)

Ο υπολογισμός παίρνει τα δεδομένα γέννησης και βγάζει ένα bodygraph - έναν οπτικό χάρτη με:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - η ενεργειακή υπογραφή
• Strategy: πώς παίρνεις αποφάσεις
• Authority: σε ποιο κέντρο να εμπιστεύεσαι τις αποφάσεις (Sacral, Emotional, Splenic κ.λπ.)
• Profile: συνδυασμός γραμμών (1/3, 4/6 κ.λπ.)
• Channels: συνδέσεις μεταξύ κέντρων που διαμορφώνουν την προσωπικότητα
• Incarnation Cross: ο σκοπός της ζωής, που προκύπτει από τέσσερις βασικές θέσεις

Στο παρασκήνιο, καθεμία από τις 64 πύλες αντιστοιχεί σε ένα εύρος εκλειπτικού μήκους. Το μήκος των πλανητών σου κατά τη γέννηση αντιστοιχίζεται σε συγκεκριμένες πύλες (και σε γραμμές μέσα σε αυτές). Ο υπολογισμός “Design” γίνεται για τη στιγμή που ο Ήλιος βρισκόταν 88° πριν από τη θέση γέννησης - περίπου 3 μήνες νωρίτερα.

Το Human Design χρησιμοποιεί δύο σημεία γέννησης:

1. Personality: η πραγματική ώρα γέννησης. Αυτή είναι η “συνειδητή” πλευρά.
2. Design: όταν ο Ήλιος ήταν 88° πριν από τη θέση γέννησης. Αυτή είναι η “ασυνείδητη” πλευρά.

Κάθε ενεργοποίηση πύλης ανήκει σε μία από τις δύο. Ο πλήρης χάρτης έχει 13 + 13 = 26 ενεργοποιήσεις.

Αυτό ακριβώς κάνει τον υπολογισμό HD βαρύτερο από έναν τυπικό αστρολογικό χάρτη - στην πράξη υπολογίζεις δύο χάρτες.

Τα περισσότερα αστρολογικά API είτε δεν υποστηρίζουν καθόλου HD είτε το υποστηρίζουν επιφανειακά (μόνο type + strategy). Μια πλήρης υλοποίηση HD χρειάζεται:

• Αντιστοίχιση των 64 πυλών (lookup table)
• 6 γραμμές για κάθε πύλη (384 κελιά)
• 9 κέντρα με λογική defined/open
• 36 κανάλια (το καθένα συνδέει δύο κέντρα)
• Υπολογισμό του Incarnation Cross
• Εξαγωγή του Profile από τη γραμμή της πύλης του Ήλιου + τη γραμμή της πύλης της Γης (Personality και Design)

Τα API που τα κάνουν όλα αυτά είναι πολύ σπάνια. Το AstroWay API έχει 12 endpoints HD - τη βαθύτερη κάλυψη που έχουμε δει σε εμπορικό API.

Φαντάσου ότι προσθέτεις HD σε μια υπάρχουσα αστρολογική εφαρμογή. Ξεκίνα από το κύριο endpoint:

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

Η μορφή της απάντησης:

{
  "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 είναι μια τεχνική για την κατανόηση της δυναμικής σε ομάδες 3–5 ατόμων. Είναι σπάνιο - οι περισσότεροι υπολογιστές HD δεν το προσφέρουν. Για HR-tech, πλατφόρμες coaching και εφαρμογές 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}`);

Οι χάρτες HD είναι ευαίσθητοι στην ώρα γέννησης. Ένα λάθος 10 λεπτών μπορεί να αλλάξει το Profile (π.χ. 1/3 → 1/4). Για χρήστες που δεν ξέρουν την ακριβή ώρα, τρέξε ανάλυση sensitivity:

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

Χρησιμοποίησέ το για να προειδοποιείς τον χρήστη: “Με αυτή την ακρίβεια το profile σου μπορεί να μετατοπιστεί. Σκέψου μια διόρθωση ώρας (rectification)”.

Αν φτιάχνεις εφαρμογή με έμφαση στο HD:

• Βασικός χρήστης: 1 χάρτης HD κατά την εγγραφή, αποθηκευμένος στην cache για πάντα = 50 credits εφάπαξ
• Ενεργός χρήστης: περιοδικές διελεύσεις + compatibility = ~200 credits/μήνα
• 100 DAU με μέτρια χρήση HD: ~110 000 credits/μήνα → το Starter ($19/μήνα) τα καλύπτει άνετα
• 1 000 DAU: ~150 000 credits/μήνα → Pro ($59/μήνα)

Τα αιτήματα compatibility είναι τα βαρύτερα (100 credits). Κράτα στην cache τα αποτελέσματα για κάθε ζεύγος χρηστών για πάντα (δεν αλλάζουν).

Το bodygraph παραδοσιακά αποδίδεται με SVG. Το API επιστρέφει τα δεδομένα για κέντρα και κανάλια, κι εσύ αποδίδεις την εικόνα. Παράδειγμα:

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

Οι συντεταγμένες είναι σταθερό πρότυπο (κάθε bodygraph έχει τα ίδια 9 κέντρα και τις 64 πύλες στις ίδιες θέσεις).

• Human Design API: σελίδα προϊόντος με την πλήρη λίστα endpoints
• Παράδειγμα: Human Design: αναλυτικό walkthrough του /v1/human-design
• Γρήγορη εκκίνηση: πάρε δωρεάν κλειδί API (έως 200 χάρτες HD/μήνα στο Free)