Human Design API: bangun aplikasi HD dengan 12 endpoint

🕓 Catatan dari 2026-04-14, diperbarui 2026-05-09. SDK TS / Python / PHP kini tersedia di registry publik - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Detailnya di changelog.

Human Design tumbuh dari sistem esoteris niche tahun 1990-an menjadi kerangka pengembangan diri yang arus utama. Aplikasi dengan jutaan pengguna telah membuatnya lazim, dan developer pun bertanya: bagaimana menghitung peta Human Design secara terprogram?

Tulisan ini membahas sisi teknisnya: apa itu perhitungan HD, API mana yang mendukungnya, dan bagaimana memasang fitur HD ke aplikasimu.

Human Design dibangun di atas tiga sistem klasik:

• Astrologi Barat: posisi planet pada saat lahir
• I Ching: 64 heksagram yang dipetakan ke 64 “gate”
• Sistem cakra: sembilan “pusat” (simpul energi)

Perhitungan mengambil data kelahiran dan menghasilkan bodygraph, peta visual yang berisi:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) - signature energi
• Strategy: cara mengambil keputusan
• Authority: pusat mana yang dipercaya saat mengambil keputusan (Sacral, Emotional, Splenic, dan sebagainya)
• Profile: kombinasi line (1/3, 4/6, dan sebagainya)
• Channels: hubungan antarpusat yang membentuk kepribadian
• Incarnation Cross: tujuan hidup, diturunkan dari empat posisi kunci

Di balik layar, masing-masing dari 64 gate sesuai dengan rentang longitude ekliptika. Longitude planet-planetmu saat lahir dipetakan ke gate tertentu (dan ke line di dalamnya). Perhitungan “Design” dilakukan untuk momen ketika Matahari berada 88° sebelum posisi saat lahir, kira-kira 3 bulan lebih awal.

Human Design memakai dua titik kelahiran:

1. Personality: waktu lahir yang sebenarnya. Ini sisi “sadar”.
2. Design: saat Matahari berada 88° sebelum posisi kelahiran. Ini sisi “tidak sadar”.

Setiap aktivasi gate termasuk ke salah satunya. Peta lengkap memiliki 13 + 13 = 26 aktivasi.

Inilah yang membuat perhitungan HD lebih berat daripada peta astrologi standar: pada dasarnya kamu menghitung dua peta.

Sebagian besar API astrologi sama sekali tidak mendukung HD, atau hanya mendukungnya secara dangkal (hanya type + strategy). Implementasi HD yang lengkap membutuhkan:

• Pemetaan 64 gate (lookup table)
• 6 line untuk setiap gate (384 sel)
• 9 pusat dengan logika defined/open
• 36 channel (masing-masing menghubungkan dua pusat)
• Perhitungan Incarnation Cross
• Penurunan Profile dari line gate Matahari + line gate Bumi (Personality dan Design)

API yang bisa melakukan semua itu sangat jarang. AstroWay API memiliki 12 endpoint HD, cakupan terdalam yang pernah kami lihat di API komersial.

Bayangkan kamu menambahkan HD ke aplikasi astrologi yang sudah ada. Mulailah dari endpoint utama:

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

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 adalah teknik untuk memahami dinamika tim dalam kelompok berisi 3–5 orang. Fitur ini langka: sebagian besar kalkulator HD tidak menyediakannya. Padahal ini emas bagi HR-tech, platform coaching, dan aplikasi 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}`);

Peta HD sensitif terhadap waktu lahir. Selisih 10 menit bisa mengubah Profile (misalnya 1/3 → 1/4). Untuk pengguna yang tidak tahu waktu lahirnya secara tepat, jalankan analisis 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

Gunakan ini untuk memperingatkan pengguna: “Dengan tingkat akurasi ini, profile-mu bisa bergeser. Pertimbangkan rektifikasi”.

Jika kamu membangun aplikasi yang berfokus pada HD:

• Pengguna dasar: 1 peta HD saat pendaftaran, di-cache selamanya = 50 kredit sekali saja
• Pengguna aktif: transit berkala + compatibility = ~200 kredit/bulan
• 100 DAU dengan penggunaan HD moderat: ~110 000 kredit/bulan → Starter ($19/bulan) menutupinya dengan mudah
• 1 000 DAU: ~150 000 kredit/bulan → Pro ($59/bulan)

Permintaan compatibility adalah yang paling berat (100 kredit). Cache hasil untuk setiap pasangan pengguna selamanya (hasilnya tidak berubah).

Rendering bodygraph biasanya dilakukan dengan SVG. API mengembalikan data pusat dan channel; kamu yang merender visualnya. 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>
  );
}

Koordinatnya berupa template tetap (setiap bodygraph memiliki 9 pusat dan 64 gate yang sama di posisi yang sama).

• Human Design API: halaman produk dengan daftar endpoint lengkap
• Contoh: Human Design: walkthrough terperinci /v1/human-design
• Mulai cepat: dapatkan API key gratis (hingga 200 peta HD/bulan di Free)