Human Design API: 12 Endpoint ile HD Uygulamaları Oluşturun

🕓 2026-04-14 tarihinde kaydedildi, 2026-05-09 tarihinde güncellendi. TS / Python / PHP SDK artık public registries’de yaşıyor - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Ayrıntılar için changelog’u ziyaret edin.

Human Design, 1990’lardan bu yana niş bir ezoterik sistemden kişisel gelişim için ana akım bir çerçeve haline geldi. Milyonlarca kullanıcıya sahip uygulamalar onu normalleştirdi - ve geliştiriciler soruyor: Human Design haritasını programlı olarak nasıl hesaplayabilirim?

Bu yazıda - teknik yön: HD hesaplamaları nelerdir, hangi API’ler bunları destekler ve HD özelliğini uygulamanıza nasıl entegre edebilirsiniz.

Human Design, üç klasik sistem üzerine inşa edilmiştir:

• Batı astrolojisi - doğum anındaki gezegen konumları
• I Ching - 64 heksagram, 64 “kapıya” eşlenmiştir
• Çakra sistemi - dokuz “merkez” (enerjik düğüm)

Hesaplama, doğum verilerini alır ve bodygraph - görsel bir harita - üretir:

• Tip (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - enerji imzası
• Strateji - karar alma yöntemi
• Otorite - hangi merkeze karar alma sırasında güvenilmesi gerektiği (Sacral, Emotional, Splenic vb.)
• Profil - çizgi kombinasyonu (1/3, 4/6 vb.)
• Kanallar - merkezler arasındaki bağlantılar, kişiliği oluşturur
• İncarnasyon Haçı - hayatın amacı, dört ana konumdan türetilir

Her bir kapı, ekliptik boylam aralığını temsil eder. Doğumunuzdaki gezegenlerin boylamı, belirli kapılarına (ve içindeki satırlara) eşlenir. “Tasarım” hesaplaması - doğumdan yaklaşık 3 ay önce, güneşin 88°‘lik kayması için yapılır.

Human Design, doğum için iki noktayı kullanır:

1. Personality - gerçek doğum zamanı. Bu, “bilinçli” yan.
2. Design - güneşin doğum konumundan 88° önce olduğu zaman. Bu, “bilinçdışı” yan.

Her bir kapı aktivasyonu, bunlardan birine aittir. Tam harita, 13 + 13 = 26 aktivasyonu içerir.

Bu, HD hesaplamalarının standart astrolojik haritalardan daha zor olmasının nedenidir - aslında iki harita hesaplıyorsunuz.

Çoğu astroloji API’si, HD’yi desteklemez veya yalnızca yüzeyel bir destek sağlar (sadece tip + strateji). Tam HD uygulaması için:

• 64 kapı eşleme tablosu
• Her kapı için 6 satır (384 hücre)
• 9 merkez ile tanımlı/açık mantık
• 36 kanal (her biri iki merkezi bağlar)
• İncarnasyon Haçı hesaplaması
• Profil çıkışı, güneş ve dünya kapılarından (Personality ve Design)

Tüm bunları yapabilen API’ler nadirdir. AstroWay API, 12 HD endpointiyle en derin kapsama sahiptir.

Zaten var olan bir astroloji uygulamasına HD eklediğinizi hayal edin. Başlangıç noktası, ana endpoint’tir:

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(`Tip: ${hd.type}`);         // örneğin, "Generator"
console.log(`Strateji: ${hd.strategy}`); // örneğin, "Cevap Vermek"
console.log(`Otorite: ${hd.authority}`); // örneğin, "Sacral"
console.log(`Profil: ${hd.profile}`);   // örneğin, "1/3"
console.log(`Tanımlı kanallar: ${hd.channels.length}`);

Cevap formatı:

{
  "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 kişilik grupların dinamiğini anlamak için bir tekniktir. Bu, çoğu HD hesaplayıcısının sunmadığı bir şeydir. Ancak bu, HR-tech, koçluk platformları ve takım oluşturma uygulamaları için altın değerinde bir şeydir.

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 tipi: ${penta.type}`);
console.log(`Grup içindeki tanımlı kanallar: ${penta.definedChannels.length}`);

HD haritaları, doğum zamanına duyarlıdır. 10 dakikalık bir hata, Profil’i değiştirebilir (örneğin, 1/3 → 1/4). Doğru zamanını bilmeyen kullanıcılar için, sensitivity analizini çalıştırın:

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

// sensitivity, zamanın ±5/15/30 dakika kaydırılmasında hangi alanların değişeceğini gösterir

Kullanıcıyı uyarmak için bunu kullanın: “Bu doğrulukta profiliniz değişebilir. Dikkatlice düşünün.”

Eğer HD odaklı bir uygulama geliştiriyorsanız:

• Temel kullanıcı: 1 HD haritası, kayıt sırasında, sonsuza kadar önbelleğe alınır = 50 kredi, bir defaya mahsus
• Etkin kullanıcı: periyodik geçişler + uyumluluk = ~200 kredi/ay
• 100 DAU ile orta düzey HD kullanımı: ~110 000 kredi/ay → Starter ($19/ay) kolayca kapsar
• 1 000 DAU: ~150 000 kredi/ay → Pro ($59/ay)

Uyumluluk sorguları en zorlu onesidir (100 kredi). Her kullanıcı çifti için sonuçları sonsuza kadar önbelleğe alın (değişmezler).

Bodygraph’in oluşturulması geleneksel olarak SVG aracılığıyla yapılır. API, merkezler ve kanallar hakkında veri döndürür; siz görseli oluşturursunuz. Örnek:

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

Koordinatlar, sabit bir şablonudur (her bodygraph aynı 9 merkezi ve 64 kapıyı aynı konumda sahiptir).

• Human Design API - ürün sayfası, tüm endpoint’lerin listesi
• Örnek: Human Design - /v1/human-design endpoint’i için ayrıntılı walkthrough
• Hızlı başlangıç - ücretsiz API anahtarı alın (ücretsiz, 200 HD haritası/ay)