# API нумерології

Цей ендпоінт обчислює піфагорійське число Життєвого шляху — єдину цифру, що згортає дату народження до її ключового нумерологічного підпису. Це лише одне обчислення в ширшому наборі, який охоплює чотири системи та приблизно десять обчислень у кожній, і виконується як чиста арифметика — без ефемерид і без астрології.

## Ендпоінт

`POST /v1/numerology/pythagorean/life-path`

- Operation ID: `numerology/pythagorean/life-path`
- Вартість: 10 кредитів (тариф 1)
- Типова латентність: 58 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/numerology/

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

Ендпоінт бере дату народження, розкладає її на окремі цифри й підсумовує їх, після чого ітеративно зводить поточну суму до однієї цифри — зберігаючи майстер-числа 11, 22 і 33 щоразу, коли вони виникають під час зведення. Відповідь містить сиру незгорнуту суму, підсумкове зведене число, булеву ознаку isMaster, яка сигналізує, що майстер-число було залишено без подальшого зведення, упорядкований перелік кроків зведення, аби ви могли відрендерити чи перевірити кожен прохід, і короткий рядок зі значенням отриманого числа. Оскільки кожен результат виводиться детерміновано з цифр календарної дати, та сама дата завжди дає побайтово однаковий результат; поле name супроводжує обчислення, але саме Життєвий шлях спирається виключно на дату. Споріднені обчислення — вираження, поклик душі, особистість, день народження, зрілість — поширюють ту саму арифметику на ім'я та інші вхідні дані.

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

Звертайтеся до нього, коли потрібне швидке й відтворюване нумерологічне трактування, а латентність і недетермінованість усього, що зачіпає ефемериди чи мовну модель, небажані. Оскільки розрахунок тривіальний і повністю детермінований, ви можете обчислювати його просто в кожному запиті, кешувати безстроково за ключем-датою або підраховувати наперед масово для всієї бази користувачів, не переймаючись розбіжностями. Він природно поєднується з рештою нумерологічного набору: викликайте life-path поряд із вираженням і покликом душі, щоб зібрати повний профіль, а тоді зберігайте зведені числа як сталі атрибути замість повторного обчислення. Добре пасує для онбордингу, збагачення профілів і персоналізації контенту, де достатньо одного опорного числа.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `name` | string | yes | The full name to accompany the reading; the Life Path itself is derived from the date, not the name. |
| `date` | string (YYYY-MM-DD) | no | The birth date in YYYY-MM-DD format, whose digits are summed and reduced to produce the Life Path number. |

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

```bash
curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ada Lovelace",
  "date": "1990-05-15"
}'
```

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

```json
{
  "ok": true,
  "data": {
    "system": "pythagorean",
    "name": "Ada Lovelace",
    "date": "1990-05-15",
    "lifePath": {
      "raw": 30,
      "reduced": 3,
      "isMaster": false,
      "steps": [
        "1+9+9+0+5+1+5 = 30",
        "3+0 = 3"
      ],
      "meaning": "Creative self-expression…"
    }
  }
}
```

## Нотатки

Майстер-числа 11, 22 і 33 свідомо не зводяться до 2, 4 і 6 — ознака isMaster повідомляє, який саме випадок стався, аби ви могли відповідно розгалузити свій текст. Це саме піфагорійська система; халдейська та інші системи набору присвоюють літерам інші числові значення і можуть повернути інший результат для тих самих вхідних даних.

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

- https://api.astroway.info/astrology-api/tarot/

---

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