# API Шадбала

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

## Ендпоінт

`POST /v1/vedic/shadbala/full`

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

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

З дати, часу, зсуву UTC і місця народження ендпоінт виводить сидеричну карту через Swiss Ephemeris за аянамшою Lahiri, а потім обчислює шість компонентів сили для кожної з класичних ґрах. Стхана-бала вимірює позиційну силу зі знакового та дивізіонального розташування; діг-бала вимірює напрямкову силу за відстанню планети від її ідеального кута; кала-бала вимірює часову силу з моменту народження; чешта-бала вимірює рухову силу з видимої швидкості планети та її ретроградності; найсарґіка-бала — це стала природна сила, яку несе кожна планета; а дрік-бала вимірює сумарну аспектну силу від аспектів, які вона отримує. Ці шість сумуються в загальну Шадбалу, і відповідь повертає показники для кожної планети в data.items, де кожен супроводжується своєю одиницею, тож оцінки в рупах однозначні.

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

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

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

| 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/vedic/shadbala/full \
  -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": "shadbala",
    "unit": "rupa",
    "items": [
      {
        "planet": "Sun",
        "total": 6.42,
        "components": {
          "sthana": 1.1,
          "dig": 0.9,
          "kala": 1.5,
          "cheshta": 0.8,
          "naisargika": 1,
          "drik": 1.1
        }
      }
    ]
  }
}
```

## Нотатки

Відповідь подає силу в рупах (класична одиниця, де одна рупа дорівнює шістдесяти одиницям шаштіамши) і позначає кожне значення його одиницею. Обчислення дотримується стандартного методу ґраха-бали з традиції Парашари, викладеного в «Бріхат Парашара Хора Шастра», й оцінюється на сидеричній карті з аянамшою Lahiri. Усі шість бал — стхана, діг, кала, чешта, найсарґіка та дрік — повертаються підсумованими в загальний показник для кожної планети.

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

- https://api.astroway.info/astrology-api/vedic-dasha/
- https://api.astroway.info/astrology-api/vedic-vargas/

---

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