Human Design API: будуй HD-застосунки на 12 ендпоінтах

🕓 Запис від 2026-04-14, оновлено 2026-05-09. TS / Python / PHP SDK тепер живуть на public registries — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Деталі в changelog.

Human Design виріс із нішевої езотеричної системи 1990-х до мейнстрімної рамки особистого розвитку. Застосунки з мільйонами користувачів його нормалізували — і розробники ставлять питання: як порахувати Human Design-карту програмно?

У цьому пості — технічний бік: що таке HD-обчислення, які API їх підтримують і як вмонтувати HD-фічу у твій застосунок.

Human Design побудований на трьох класичних системах:

• Західна астрологія — позиції планет у момент народження
• I Ching — 64 гексаграми, замаплені на 64 «ворота»
• Чакрова система — дев’ять «центрів» (енергетичних вузлів)

Обчислення бере дані народження і видає bodygraph — візуальну карту з:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — енергетичний сигнатур
• Strategy — як приймати рішення
• Authority — якому центру довіряти при рішеннях (Sacral, Emotional, Splenic тощо)
• Profile — комбінація ліній (1/3, 4/6 тощо)
• Channels — зв’язки між центрами, що формують особистість
• Incarnation Cross — призначення життя, похідне від чотирьох ключових позицій

Під капотом кожні з 64 воріт відповідають діапазону еклiптичної довготи. Довгота твоїх планет при народженні мапиться на конкретні ворота (і рядки всередині них). Розрахунок «Design» — для зсуву Сонця на 88° до народження — приблизно 3 місяці раніше.

Human Design використовує дві точки народження:

1. Personality — реальний час народження. Це «свідомий» бік.
2. Design — коли Сонце було на 88° до позиції народження. Це «несвідомий» бік.

Кожна активація воріт належить до одного з них. Повна карта має 13 + 13 = 26 активацій.

Саме це робить HD-обчислення важчим за стандартну астрологічну карту — ти фактично рахуєш дві карти.

Більшість API астрології або взагалі не підтримують HD, або мають поверхневу підтримку (тільки type + strategy). Повна реалізація HD потребує:

• Мапінгу 64 воріт (lookup table)
• 6 ліній на кожні ворота (384 клітинок)
• 9 центрів із логікою defined/open
• 36 каналів (кожен з’єднує два центри)
• Обчислення Incarnation Cross
• Виведення Profile з лінії воріт Сонця + лінії воріт Землі (Personality і Design)

API, які вміють усе це, — велика рідкість. AstroWay API має 12 HD-ендпоінтів — найглибше покриття, яке ми бачили в комерційному API.

Уяви, що додаєш HD у вже наявний астрологічний застосунок. Починай із головного ендпоінта:

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(`Type: ${hd.type}`);         // наприклад, "Generator"
console.log(`Strategy: ${hd.strategy}`); // наприклад, "To Respond"
console.log(`Authority: ${hd.authority}`); // наприклад, "Sacral"
console.log(`Profile: ${hd.profile}`);   // наприклад, "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, коучинг-платформ і тімбілдинг-застосунків.

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 type: ${penta.type}`);
console.log(`Defined channels in group: ${penta.definedChannels.length}`);

HD-карти чутливі до часу народження. Помилка в 10 хвилин може змінити Profile (наприклад, 1/3 → 1/4). Для користувачів, які не знають точного часу, запускай sensitivity-аналіз:

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

// sensitivity покаже, які поля зміняться при зсуві часу на ±5/15/30 хв

Використовуй це, щоб попереджати користувача: «На цій точності твій profile може зсунутись. Розглянь ректифікацію».

Якщо будуєш HD-focused застосунок:

• Базовий користувач: 1 HD-карта при реєстрації, кешована назавжди = 50 кредитів одноразово
• Активний користувач: періодичні транзити + compatibility = ~200 кредитів/міс
• 100 DAU з помірним використанням HD: ~110 000 кредитів/міс → Starter ($19/міс) легко покриває
• 1 000 DAU: ~150 000 кредитів/міс → Pro ($59/міс)

Compatibility-запити найважчі (100 кредитів). Кешуй результати для кожної пари користувачів назавжди (вони незмінні).

Рендеринг bodygraph традиційно роблять через SVG. API повертає дані про центри й канали; ти рендериш візуал. Приклад:

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 центрів і 64 ворота на тих самих позиціях).

• Human Design API — продуктова сторінка з повним списком ендпоінтів
• Приклад: Human Design — детальний walkthrough /v1/human-design
• Швидкий старт — отримай безкоштовний API-ключ (до 200 HD-карт/міс на Free)