Human Design API: 12 endpoint ile HD uygulamaları geliştirin

🕓 2026-04-14 tarihli yazı, 2026-05-09’da güncellendi. TS / Python / PHP SDK’ları artık public registry’lerde: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Ayrıntılar changelog sayfasında.

Human Design, 1990’ların niş ezoterik sisteminden kişisel gelişimin ana akım çerçevelerinden birine dönüştü. Milyonlarca kullanıcısı olan uygulamalar onu sıradanlaştırdı ve geliştiriciler şu soruyu soruyor: Human Design haritası programatik olarak nasıl hesaplanır?

Bu yazıda işin teknik tarafına bakıyoruz: HD hesaplaması nedir, hangi API’ler bunu destekler ve uygulamanıza bir HD özelliğini nasıl eklersiniz.

Human Design üç klasik sistem üzerine kuruludur:

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

Hesaplama doğum verilerini alır ve bir bodygraph üretir, yani şunları içeren görsel bir harita:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector): enerji imzası
• Strategy: kararların nasıl alınacağı
• Authority: karar verirken hangi merkeze güvenileceği (Sacral, Emotional, Splenic vb.)
• Profile: çizgi kombinasyonu (1/3, 4/6 vb.)
• Channels: merkezler arasında kişiliği oluşturan bağlantılar
• Incarnation Cross: dört temel konumdan türetilen yaşam amacı

Arka planda 64 kapının her biri bir ekliptik boylam aralığına karşılık gelir. Doğumdaki gezegenlerinizin boylamı belirli bir kapıya (ve içindeki bir çizgiye) eşlenir. “Design” hesaplaması, Güneş’in doğumdan 88° önceki konumu içindir: yaklaşık 3 ay öncesi.

Human Design iki doğum noktası kullanır:

1. Personality: gerçek doğum zamanı. Bu “bilinçli” taraftır.
2. Design: Güneş’in doğum konumundan 88° geride olduğu an. Bu “bilinçdışı” taraftır.

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

HD hesaplamasını standart bir astroloji haritasından daha zor yapan da budur: aslında iki harita hesaplıyorsunuz.

Astroloji API’lerinin çoğu HD’yi ya hiç desteklemez ya da yüzeysel destekler (yalnızca type + strategy). Tam bir HD uygulaması şunları gerektirir:

• 64 kapının eşlemesi (lookup table)
• Her kapı için 6 çizgi (384 hücre)
• defined/open mantığıyla 9 merkez
• 36 kanal (her biri iki merkezi bağlar)
• Incarnation Cross hesaplaması
• Profile’ın Güneş kapısı çizgisi + Dünya kapısı çizgisinden türetilmesi (Personality ve Design)

Bunların hepsini yapabilen API’ler oldukça nadirdir. AstroWay API 12 HD endpoint’i sunar: ticari bir API’de gördüğümüz en derin kapsam.

Mevcut bir astroloji uygulamasına HD eklediğinizi düşünün. Ana endpoint ile başlayın:

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

Yanıtın yapısı:

{
  "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 gruplarda ekip dinamiğini anlamaya yönelik bir tekniktir. Nadir bulunur: HD hesaplayıcılarının çoğu bunu sunmaz. Ama HR-tech, koçluk platformları ve takım oluşturma uygulamaları için tam bir hazine.

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 haritaları doğum saatine duyarlıdır. 10 dakikalık bir hata Profile’ı değiştirebilir (örneğin 1/3 → 1/4). Tam doğum saatini bilmeyen kullanıcılar için sensitivity analizi çalıştırın:

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

Bunu kullanıcıyı uyarmak için kullanın: “Bu doğrulukta profile’ınız kayabilir. Rektifikasyonu değerlendirin.”

HD odaklı bir uygulama geliştiriyorsanız:

• Temel kullanıcı: kayıtta 1 HD haritası, kalıcı olarak önbelleğe alınır = tek seferlik 50 kredi
• Aktif kullanıcı: düzenli transitler + compatibility = ayda ~200 kredi
• Orta düzeyde HD kullanan 100 DAU: ayda ~110 000 kredi → Starter (ayda $19) rahatça karşılar
• 1 000 DAU: ayda ~150 000 kredi → Pro (ayda $59)

Compatibility istekleri en ağır olanlardır (100 kredi). Her kullanıcı çifti için sonuçları kalıcı olarak önbelleğe alın (değişmezler).

Bodygraph çizimi geleneksel olarak SVG ile yapılır. API merkezler ve kanallar hakkında veri döndürür, görseli siz çizersiniz. Ö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 şablondur (her bodygraph aynı 9 merkezi ve 64 kapıyı aynı konumlarda taşır).

• Human Design API: endpoint’lerin tam listesini içeren ürün sayfası
• Örnek: Human Design: /v1/human-design için ayrıntılı walkthrough
• Hızlı başlangıç: ücretsiz bir API anahtarı alın (Free planda ayda 200’e kadar HD haritası)