Human Design API: δημιουργήστε εφαρμογές HD με 12 τελικούς πόρους

🕓 Εγγραφή από 2026-04-14, ενημερώθηκε 2026-05-09. Τα TS / Python / PHP SDK ζουν τώρα σε δημόσιους καταλόγους — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Λεπτομέρειες στο changelog.

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

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

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

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

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

• Τύπος (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — την ενεργειακή υπογραφή
• Στρατηγική — πώς να λαμβάνεις αποφάσεις
• Αρχή — σε ποιο κέντρο να βασίζεσαι στις αποφάσεις σου (Sacral, Emotional, Splenic κ.λπ.)
• Προφίλ — συνδυασμός γραμμών (1/3, 4/6 κ.λπ.)
• Κανάλια — συνδέσεις μεταξύ των κέντρων που διαμορφώνουν την προσωπικότητα
• Σταυρός Ενσάρκωσης — τον προορισμό της ζωής, που προέρχεται από τέσσερις βασικές θέσεις

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

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

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

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

Αυτός είναι ο λόγος που οι υπολογισμοί Human Design είναι πιο περίπλοκοι από έναν τυπικό αστρολογικό χάρτη — υπολογίζεις ουσιαστικά δύο χάρτες.

Τα περισσότερα αστρολογικά API είτε δεν υποστηρίζουν καθόλου το Human Design είτε προσφέρουν επιφανειακή υποστήριξη (μόνο τύπος + στρατηγική). Για μια πλήρη υλοποίηση Human Design χρειάζεσαι:

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

Τα API που μπορούν να κάνουν όλα αυτά είναι σπάνια. Το AstroWay API προσφέρει 12 Human Design endpoints — την πιο ολοκληρωμένη κάλυψη που έχουμε δει σε ένα εμπορικό API.

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

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(`Τύπος: ${hd.type}`);         // π.χ. "Generator"
console.log(`Στρατηγική: ${hd.strategy}`); // π.χ. "To Respond"
console.log(`Αρχή: ${hd.authority}`);     // π.χ. "Sacral"
console.log(`Προφίλ: ${hd.profile}`);     // π.χ. "1/3"
console.log(`Ορισμένα κανάλια: ${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 ατόμων. Είναι σπάνιο — οι περισσότεροι υπολογιστές Human Design δεν το προσφέρουν. Αλλά είναι χρυσός για πλατφόρμες HR-tech, πλατφόρμες coaching και εφαρμογές team building.

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: ${penta.type}`);
console.log(`Ορισμένα κανάλια στην ομάδα: ${penta.definedChannels.length}`);

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

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

// η sensitivity θα δείξει ποια πεδία θα αλλάξουν με μετατόπιση ±5/15/30 λεπτών

Χρησιμοποίησε αυτό για να προειδοποιείς τον χρήστη: «Με αυτήν την ακρίβεια το προφίλ σου μπορεί να αλλάξει. Σκέψου τη ρεκτιфикация».

Αν κατασκευάζεις μια εφαρμογή επικεντρωμένη στο Human Design:

• Βασικός χρήστης: 1 χάρτης Human Design κατά την εγγραφή, κρυφαρίσματος για πάντα = 50 πιστώσεις μία φορά
• Ενεργός χρήστης: περιοδικές μεταβάσεις + συμβατότητα = ~200 πιστώσεις/μήνα
• 100 DAU με μέτρια χρήση Human Design: ~110.000 πιστώσεις/μήνα → το Starter ($19/μήνα) καλύπτει εύκολα
• 1.000 DAU: ~150.000 πιστώσεις/μήνα → το Pro ($59/μήνα)

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

Η απόδοση ενός 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 — ένας λεπτομερής οδηγός για το /v1/human-design
• Γρήγορη εκκίνηση — απόκτησε ένα δωρεάν κλειδί API (έως 200 χάρτες Human Design/μήνα στο δωρεάν πρόγραμμα)