# API Дизайну людини

Цей ендпоінт обчислює бодиграф Дизайну людини з однієї події народження. Він поєднує натальну карту Особистості з картою Дизайну — взятою приблизно за 88° сонячної дуги до народження, тобто десь на три місяці раніше — і виводить механічні елементи бодиграфа: Тип, Стратегію, Авторитет, Профіль, Центри, Канали, Ворота та Хрест втілення.

## Ендпоінт

`POST /v1/human-design`

- Operation ID: `human-design`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 61 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/human-design/

## Що обчислює

Ендпоінт переводить момент і місце народження у два знімки ефемерид — карту Особистості в момент народження та карту Дизайну в точці приблизно за 88 градусів сонячної дуги раніше — а тоді зчитує планетарні розташування обох, аби скласти бодиграф. З цієї пари він визначає енергетичний Тип, Стратегію, що з нього випливає, тему не-себе, Авторитет ухвалення рішень, Профіль, малюнок визначених і невизначених Центрів, активні Канали й Ворота та Хрест втілення. Відповідь повертає type, strategy, notSelfTheme, authority, profile, definition і cross. Усе обчислюється з сирої планетарної механіки, а не копіюється з якогось описового корпусу, тож ви отримуєте структурний кістяк карти — позначки та з'єднання — готовий до накладання вашого власного інтерпретаційного контенту.

## Коли використовувати

Звертайтеся до нього щоразу, коли потрібен механічний фундамент трактування Дизайну людини, а текст ви хочете надати самі. Обчисліть бодиграф один раз для конкретної події народження, збережіть повернуті type, authority, profile і definition і живіть з цих збережених полів увесь продукт — пошук контенту, графіку, логіку сумісності — замість повторного обчислення при кожному перегляді. Це правильна відправна точка перед будь-якою глибшою функцією Дизайну людини, адже кожен наступний елемент посилається на ту саму топологію визначених центрів і каналів, яку розв'язує цей ендпоінт. Сприймайте його вихід як сталий для користувача: для фіксованої події народження він не змінюється, тож кешуйте безстроково.

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Birth-place longitude, decimal degrees (east positive). |

## Приклад запиту

```bash
curl -X POST https://api.astroway.info/v1/human-design \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52
}'
```

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "type": "Generator",
    "strategy": "To Respond",
    "notSelfTheme": "Frustration",
    "authority": "Sacral",
    "profile": "3/5",
    "definition": "Single",
    "cross": "Right Angle Cross of …"
  }
}
```

## Нотатки

Систему Дизайну людини синтезував Ра Уру Ху 1987 року. Цей ендпоінт обчислює лише механіку з ефемерид — Тип, Центри, Канали, Ворота тощо — і свідомо не відтворює жодного захищеного авторським правом описового тексту, пов'язаного із системою; поєднуйте структурний вихід із власним інтерпретаційним текстом. Зсув карти Дизайну приблизно на 88° сонячної дуги означає, що вона припадає десь на три місяці до народження, а не на фіксований календарний інтервал.

## Пов’язані техніки

- https://api.astroway.info/astrology-api/natal-chart/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md