API Human Design: Membangun Aplikasi HD dengan 12 Endpoint

🕓 Catatan dari 2026-04-14, diperbarui 2026-05-09. TS / Python / PHP SDK sekarang hidup di public registries — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Detailnya di changelog.

Human Design telah tumbuh dari sistem esoteris niche pada 1990-an menjadi kerangka pengembangan pribadi mainstream. Aplikasi dengan jutaan pengguna telah menormalkannya — dan pengembang bertanya: bagaimana menghitung kartu Human Design secara terprogram?

Dalam posting ini — sisi teknis: apa itu perhitungan HD, API mana yang mendukungnya, dan bagaimana memasukkan fitur HD ke dalam aplikasi Anda.

Human Design dibangun di atas tiga sistem klasik:

• Astrologi Barat — posisi planet pada saat kelahiran
• I Ching — 64 heksagram, dipetakan ke 64 “gerbang”
• Sistem Chakra — sembilan “pusat” (simpul energi)

Perhitungan mengambil data kelahiran dan mengeluarkan bodygraph — peta visual dengan:

• Tipe (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — tanda energi
• Strategi — cara mengambil keputusan
• Otoritas — pusat mana yang dipercaya dalam pengambilan keputusan (Sacral, Emosional, Splenic, dll.)
• Profil — kombinasi garis (1/3, 4/6, dll.)
• Saluran — koneksi antara pusat, yang membentuk kepribadian
• Incarnation Cross — tujuan hidup, yang diturunkan dari empat posisi kunci

Di bawah kap, setiap 64 gerbang sesuai dengan rentang garis bujur ekliptika. Garis bujur planet Anda pada saat kelahiran dipetakan ke gerbang tertentu (dan baris di dalamnya). Perhitungan “Desain” — untuk pergeseran Matahari sebesar 88° sebelum kelahiran — sekitar 3 bulan sebelumnya.

Human Design menggunakan dua titik kelahiran:

1. Personality — waktu kelahiran sebenarnya. Ini adalah “sisi sadar”.
2. Desain — ketika Matahari berada pada 88° sebelum posisi kelahiran. Ini adalah “sisi tidak sadar”.

Setiap aktivasi gerbang milik salah satu dari keduanya. Kartu lengkap memiliki 13 + 13 = 26 aktivasi.

Inilah yang membuat perhitungan HD lebih sulit daripada kartu astrologi standar — Anda sebenarnya menghitung dua kartu.

Sebagian besar API astrologi tidak mendukung HD, atau memiliki dukungan yang dangkal (hanya tipe + strategi). Implementasi HD yang lengkap memerlukan:

• Pemetaan 64 gerbang (tabel lookup)
• 6 garis untuk setiap gerbang (384 sel)
• 9 pusat dengan logika defined/open
• 36 saluran (masing-masing menghubungkan dua pusat)
• Perhitungan Incarnation Cross
• Pengeluaran Profil dengan garis gerbang Matahari + garis gerbang Bumi (Personality dan Desain)

API yang dapat melakukan semua ini sangat langka. AstroWay API memiliki 12 endpoint HD — cakupan terdalam yang pernah kami lihat di API komersial.

Bayangkan Anda menambahkan HD ke aplikasi astrologi yang sudah ada. Mulailah dengan endpoint utama:

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(`Tipe: ${hd.type}`);         // contoh, "Generator"
console.log(`Strategi: ${hd.strategy}`); // contoh, "To Respond"
console.log(`Otoritas: ${hd.authority}`); // contoh, "Sacral"
console.log(`Profil: ${hd.profile}`);   // contoh, "1/3"
console.log(`Saluran yang didefinisikan: ${hd.channels.length}`);

Bentuk respons:

{
  "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 — teknik memahami dinamika tim dalam grup 3–5 orang. Ini adalah hal yang langka — sebagian besar kalkulator HD tidak menawarkannya. Tapi ini adalah emas untuk HR-tech, platform pelatihan, dan aplikasi pembangunan tim.

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(`Tipe Penta: ${penta.type}`);
console.log(`Saluran yang didefinisikan dalam grup: ${penta.definedChannels.length}`);

Kartu HD sensitif terhadap waktu kelahiran. Kesalahan 10 menit dapat mengubah Profil (misalnya, 1/3 → 1/4). Untuk pengguna yang tidak mengetahui waktu kelahiran yang tepat, jalankan analisis sensitivitas:

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

// sensitivity menunjukkan bidang mana yang berubah ketika waktu bergeser ±5/15/30 menit

Gunakan ini untuk memperingatkan pengguna: “Pada presisi ini, profil Anda mungkin bergeser. Pertimbangkan untuk merektifikasi”.

Jika Anda membangun aplikasi yang berfokus pada HD:

• Pengguna dasar: 1 kartu HD pada saat pendaftaran, disimpan selamanya = 50 kredit sekali
• Pengguna aktif: transisi berkala + kesesuaian = ~200 kredit/bulan
• 100 DAU dengan penggunaan HD yang moderat: ~110.000 kredit/bulan → Starter ($19/bulan) dengan mudah menutupi
• 1.000 DAU: ~150.000 kredit/bulan → Pro ($59/bulan)

Permintaan kesesuaian adalah yang paling berat (100 kredit). Simpan hasilnya untuk setiap pasangan pengguna selamanya (mereka tidak berubah).

Pengrenderan bodygraph secara tradisional dilakukan melalui SVG. API mengembalikan data tentang pusat dan saluran; Anda mengrender visual. Contoh:

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

Koordinat — pola tetap (setiap bodygraph memiliki 9 pusat dan 64 gerbang pada posisi yang sama).

• Human Design API — halaman produk dengan daftar endpoint lengkap
• Contoh: Human Design — walkthrough terperinci /v1/human-design
• Panduan Cepat — dapatkan kunci API gratis (hingga 200 kartu HD/bulan pada Free)