# API голограмного профілю Gene Keys

Голограмний профіль розкладає одинадцять сфер на три послідовності, і кожна сфера несе ворота й лінію, виведені з планетарного положення при народженні або в момент дизайну. Цей ендпоінт віддає весь профіль одним викликом: Активацію, Венеру і Перлину, з воротами й лінією для кожної сфери.

## Ендпоінт

`POST /v1/hd/hologenetic`

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

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

За даними народження ендпоінт виводить ворота й лінію для кожної з одинадцяти сфер і групує їх у три послідовності. Послідовність Активації охоплює Справу Життя, Еволюцію, Сяйво і Призначення; послідовність Венери охоплює Притягання, IQ, EQ і SQ; послідовність Перлини охоплює Покликання, Культуру і Перлину. Кожна сфера повідомляє, яка планета її утворила і чи походить вона з боку особистості чи дизайну, тож виведення піддається перевірці, а не лишається непрозорим, і кожна несе назву та опис англійською, українською та російською. Приклад віддає ворота 23 лінію 6 для Справи Життя, узяті від Сонця. Ворота беруться з того самого поділу зодіаку на 64 частини, який використовує Human Design, тож профіль, порахований тут, узгоджується з бодиграфом від ендпоінтів Human Design для тих самих даних, а не суперечить йому.

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

Беріть це, коли будуєте саме для аудиторії Gene Keys, суміжної з Human Design, але з іншими питаннями: споглядальними, а не механічними, зорієнтованими радше на послідовність тем для проживання, ніж на стратегію й авторитет. Пасує застосунку профілю, супутнику для споглядання, курсовій платформі, що відкриває матеріал посферно, або AI-провіднику, який веде користувача по одній сфері за раз. Оскільки відповідь містить планету й позначку особистості чи дизайну для кожної сфери, профіль можна показати як виведення, а не лише як результат, а саме цього й чекає серйозна аудиторія цієї системи. Поєднуйте з ендпоінтами Human Design, коли продукт хоче віддати обидва прочитання з одного введення даних народження.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. Lines change faster than gates, so an accurate time matters. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment. |
| `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/hd/hologenetic \
  -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": {
    "spheres": [
      {
        "id": "lifework",
        "name_en": "Life's Work",
        "sequence": "activation",
        "planet": "Sun",
        "gate": 23,
        "line": 6
      }
    ],
    "activationSequence": [],
    "venusSequence": [],
    "pearlSequence": []
  }
}
```

## Нотатки

Одинадцять сфер у послідовностях Активації, Венери й Перлини, кожна з воротами, лінією, планетою-джерелом і позначкою особистості чи дизайну. Ворота йдуть за стандартним поділом зодіаку на 64 гексаграми, спільним із Human Design, тож профілі узгоджуються з бодиграфом для тих самих даних. Положення рахує рушій Swiss Ephemeris; назви та описи сфер повертаються англійською, українською та російською.

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

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

---

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