Human Design API: 12 एंडपॉइंट पर HD ऐप्स बनाइए

🕓 2026-04-14 की पोस्ट, 2026-05-09 को अपडेट की गई। TS / Python / PHP SDK अब public registries पर उपलब्ध हैं - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist)। विवरण changelog में।

Human Design 1990 के दशक की एक niche गूढ़ प्रणाली से बढ़कर व्यक्तिगत विकास का mainstream फ़्रेमवर्क बन चुका है। लाखों यूज़र्स वाले ऐप्स ने इसे आम बना दिया है - और डेवलपर पूछते हैं: Human Design चार्ट को प्रोग्राम से कैसे कैलकुलेट करें?

इस पोस्ट में तकनीकी पक्ष है: HD की गणना क्या है, कौन-से API इसे सपोर्ट करते हैं और अपने ऐप में HD फ़ीचर कैसे जोड़ें।

Human Design तीन क्लासिकल प्रणालियों पर बना है:

• पाश्चात्य ज्योतिष: जन्म के क्षण में ग्रहों की स्थितियाँ
• I Ching: 64 हेक्साग्राम, जो 64 “gates” पर मैप किए गए हैं
• चक्र प्रणाली: नौ “centers” (ऊर्जा के केंद्र)

गणना जन्म का डेटा लेती है और एक bodygraph देती है - एक विज़ुअल चार्ट, जिसमें होते हैं:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - ऊर्जा का सिग्नेचर
• Strategy: निर्णय कैसे लें
• Authority: निर्णय लेते समय किस center पर भरोसा करें (Sacral, Emotional, Splenic आदि)
• Profile: lines का संयोजन (1/3, 4/6 आदि)
• Channels: centers के बीच के कनेक्शन, जो व्यक्तित्व बनाते हैं
• Incarnation Cross: जीवन का उद्देश्य, चार मुख्य स्थितियों से निकाला गया

अंदर की बात यह है कि 64 में से हर gate भचक्र (ecliptic) देशांतर की एक रेंज से मेल खाता है। जन्म के समय आपके ग्रहों का देशांतर किसी ख़ास gate (और उसके अंदर की line) पर मैप होता है। “Design” की गणना उस क्षण के लिए होती है जब सूर्य जन्म की स्थिति से 88° पीछे था - लगभग 3 महीने पहले।

Human Design जन्म के दो बिंदुओं का इस्तेमाल करता है:

1. Personality: जन्म का वास्तविक समय। यह “सचेत” पक्ष है।
2. Design: वह क्षण जब सूर्य जन्म की स्थिति से 88° पीछे था। यह “अचेत” पक्ष है।

हर gate activation इन दोनों में से किसी एक का होता है। पूरे चार्ट में 13 + 13 = 26 activations होते हैं।

यही HD की गणना को सामान्य ज्योतिषीय चार्ट से भारी बनाता है - असल में आप दो चार्ट कैलकुलेट करते हैं।

ज़्यादातर ज्योतिष API या तो HD सपोर्ट ही नहीं करते, या बहुत सतही सपोर्ट देते हैं (सिर्फ़ type + strategy)। HD के पूरे implementation के लिए चाहिए:

• 64 gates की मैपिंग (lookup table)
• हर gate की 6 lines (384 सेल)
• defined/open लॉजिक वाले 9 centers
• 36 channels (हर एक दो centers को जोड़ता है)
• Incarnation Cross की गणना
• Sun gate line + Earth gate line (Personality और Design) से Profile निकालना

जो API यह सब कर पाते हैं, वे बहुत कम हैं। AstroWay API में 12 HD एंडपॉइंट हैं - किसी commercial API में हमने इससे गहरा कवरेज नहीं देखा।

मान लीजिए आप किसी मौजूदा ज्योतिष ऐप में HD जोड़ रहे हैं। मुख्य एंडपॉइंट से शुरू करें:

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, कोचिंग प्लेटफ़ॉर्म और 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-focused ऐप बना रहे हैं:

• सामान्य यूज़र: रजिस्ट्रेशन पर 1 HD चार्ट, हमेशा के लिए कैश = एक बार 50 क्रेडिट
• सक्रिय यूज़र: समय-समय पर ट्रांज़िट + compatibility = ~200 क्रेडिट/माह
• HD के मध्यम इस्तेमाल वाले 100 DAU: ~110 000 क्रेडिट/माह → Starter ($19/माह) आसानी से कवर करता है
• 1 000 DAU: ~150 000 क्रेडिट/माह → Pro ($59/माह)

Compatibility अनुरोध सबसे भारी हैं (100 क्रेडिट)। हर यूज़र-जोड़ी के नतीजे हमेशा के लिए कैश करें (वे बदलते नहीं)।

bodygraph का रेंडरिंग पारंपरिक रूप से SVG से होता है। API centers और channels का डेटा लौटाता है; विज़ुअल आप रेंडर करते हैं। उदाहरण:

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 centers और 64 gates उन्हीं जगहों पर होते हैं)।

• Human Design API: एंडपॉइंट की पूरी सूची के साथ प्रोडक्ट पेज
• उदाहरण: Human Design: /v1/human-design का विस्तृत walkthrough
• क्विक स्टार्ट: मुफ़्त API key पाएँ (Free पर हर महीने 200 HD चार्ट तक)