# Упаї (ремедії)

**Упая** (उपाय) - засіб для слабкої чи ураженої ґрахи або для доші. Більшість переліків змішують три шари й не кажуть, де який: що приписує класичний текст, що додають сучасні посібники і чого вчить окрема школа. Тут кожен пункт має **`source`** і **`basis`**:

- **`classical`**: це є в названому тексті. Ґраха шанті взято з BPHS, розд. 84, і звірено рядок за рядком з Яджнявалк'я-смріті, яка дає ті самі переліки в тому самому порядку.
- **`modern-popular`**: сучасна практика з найближчим задокументованим джерелом. Біджа-мантри, відповідність мукхі рудракші ґрахам, пости за днями тижня, янтри ґрах.

Камені й упаї Лал Кітаб тут не повторюються: пункти ведуть на [Ратну](/vedic/gemstones/) і `/v1/vedic/lal-kitab/remedies`, де вони вже є.

## Ендпойнти

| Ендпойнт | Кредити | Що повертає |
|---|---|---|
| `GET /v1/vedic/remedies/catalogue` | 5 | Увесь каталог: дев'ять ґрах, вісім дош |
| `GET /v1/vedic/remedies/by-graha?graha=saturn` | 5 | Засоби однієї ґрахи і доші, що на неї спираються |
| `GET /v1/vedic/remedies/by-dosha?dosha=sade-sati` | 5 | Одна доша: її класичний статус, власні обряди, засоби її ґрах |
| `GET /v1/vedic/remedies/by-type?type=rudraksha` | 5 | Усі пункти одного типу або кількох через кому |
| `POST /v1/vedic/remedies/chart` | 20 | З натальної карти: слабкі чи уражені ґрахи, наявні доші, їхні засоби і причина вибору кожної ґрахи |

`type` - одне з `mantra`, `puja`, `deity`, `yantra`, `rudraksha`, `fasting`, `charity`, `colour`, `gemstone`, `lal-kitab`. Три довідкові ендпойнти приймають його як необов'язковий фільтр; маршрут карти приймає масив `types` у тілі.

Ґрахи: `sun`, `moon`, `mars`, `mercury`, `jupiter`, `venus`, `saturn`, `rahu`, `ketu`. Доші: `mangal`, `kaal-sarp`, `pitru`, `sade-sati`, `grahan`, `shrapit`, `guru-chandal`, `kemadruma`.

## Що в записі ґрахи

| Тип | Пункт | Basis |
|---|---|---|
| `mantra` | Ведична мантра за початковими словами, з посиланням на Веду і кількістю джапи з BPHS 84 | classical |
| `mantra` | Біджа-мантра | modern-popular |
| `puja` | Ґраха шанті: матеріал зображення, образ для споглядання, самідх, хаван, їжа | classical |
| `charity` | Дакшина наприкінці обряду | classical |
| `colour` | Колір ґрахи для квітів і одягу та день тижня, яким вона править | classical |
| `rudraksha` | Мукхі і божество, яке Шіва-пурана дає цій мукхі | modern-popular |
| `yantra` | Магічний квадрат наваґрахи, як принцип | modern-popular |
| `fasting` | Піст у день ґрахи (для Раху й Кету немає) | modern-popular |
| `deity`, `charity` | BPHS 83.109-111, написано для однієї скарги: відсутності сина через цю ґраху | classical |
| `gemstone` | Назва каменя і посилання на таблицю наваратни | classical |
| `lal-kitab` | Посилання на маршрут Лал Кітаб з ідентифікатором ґрахи | modern-popular |

## Доші

Кожна доша прямо каже, чи є вона в класичних текстах (`classicalStatus`). Каал Сарп, Шрапіт і Ґуру-Чандал там відсутні: це пізніші вчення, і їхні засоби - засоби відповідних ґрах. Де BPHS має обряд для спорідненої причини, він повертається в `specific` з приміткою, для чого його написано:

- **Пітру**: BPHS 83.31-33 (прокляття батька: шраддха в Ґаї) і 83.106-108 (не виконана шраддха батьків: пінда-дана, Рудра-абхішека).
- **Каал Сарп**: BPHS 83.17-19, обряд для прокляття змія. BPHS не знає Каал Сарп; застосування цього обряду до неї - пізніша практика, і пункт про це каже.
- **Ґрахан**: BPHS 91.1-14, обряд для народження під час затемнення, а це рідше, ніж натальне поєднання, яке повертає детектор доші.
- **Кемадрума**: класична (BPHS 37.11-13), але засобу там немає.

## Маршрут карти

`POST /v1/vedic/remedies/chart` обирає ґраху, коли спрацьовує будь-що з цього, і перелічує всі причини, що спрацювали:

1. **Шадбала нижче вимоги BPHS 27.32-33**: 390 віруп для Сонця, 360 Місяць, 300 Марс, 420 Меркурій, 390 Юпітер, 330 Венера, 300 Сатурн. Числа ті самі, що в [`/vedic/shadbala/full`](/vedic/shadbala/).
2. **У падінні**, за сидеричними знаками.
3. **Спалена**, з орбісами, як у [`/vedic/gemstones`](/vedic/gemstones/).
4. **Утворює наявну дошу**: Манґал, Каал Сарп, Пітру, Шрапіт, Ґрахан, Ґуру-Чандал як у [`/vedic/doshas/parashara/full`](/vedic/doshas/); Кемадрума за BPHS 37.11-13; Саде Саті на `targetDate` (сьогодні, якщо не передано).

Раху й Кету не мають шадбали, тож їх обирають лише через дошу. `checked` показує кожну ґраху проти її вимоги і результат кожної доші, тож видно і те, що не спрацювало. Маршрут не ранжує засоби і не каже, який виконувати.

**Caution:**
**Координати обов'язкові** на маршруті карти. Шадбала і доші читають лаґну, тому `latitude` і `longitude` тут не дорівнюють нулю за замовчуванням: без них буде 400.

## Приклад

  **cURL**
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/vedic/remedies/chart \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-05-15",
        "time": "15:30:00",
        "timezoneOffset": 3,
        "latitude": 50.45,
        "longitude": 30.52,
        "targetDate": "2026-11-07",
        "types": ["mantra", "puja"]
      }'
    ```

  **Node.js**
    ```ts
    const r = await fetch('https://api.astroway.info/v1/vedic/remedies/chart', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-05-15', time: '15:30:00', timezoneOffset: 3,
        latitude: 50.45, longitude: 30.52, targetDate: '2026-11-07',
      }),
    });
    const { data } = await r.json();
    for (const g of data.selected.grahas) {
      console.log(g.name, g.reasons.map((x: any) => x.detail).join(' '));
      for (const item of g.remedies) console.log(`  ${item.type} (${item.basis}): ${item.title}`);
    }
    ```

  **Python**
    ```python
    import os, requests

    r = requests.get(
        'https://api.astroway.info/v1/vedic/remedies/by-graha',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
        params={'graha': 'saturn', 'type': 'mantra,charity'},
    )
    for item in r.json()['data']['remedies']:
        print(item['title'], '|', item['basis'], '|', item['source'])
    ```

### Приклад відповіді (маршрут карти, скорочено)

Текстові поля відповіді англійською.

```json
{
  "type": "remedies-for-chart",
  "lagna": { "sign": 5, "signName": "Virgo" },
  "selected": {
    "grahas": [
      {
        "graha": "mercury",
        "name": "Mercury",
        "reasons": [
          {
            "code": "shadbala-below-required",
            "detail": "Shadbala 405.8 virupa, below the 420 BPHS requires for Mercury.",
            "source": "BPHS ch. 27 vv. 32-33"
          }
        ],
        "remedies": [
          {
            "id": "mercury.vedic-mantra",
            "type": "mantra",
            "title": "Vedic mantra of Mercury",
            "detail": { "mantraKind": "vedic", "pratika": "Udbudhyasva", "vedaRef": "Shukla Yajurveda (Vajasaneyi) 15.54", "japaCount": 9000 },
            "basis": "classical",
            "source": "BPHS ch. 84 vv. 17-20 (graha shanti; ch. 86 in the G.C. Sharma 2006 edition) for the count; ..."
          }
        ]
      }
    ],
    "doshas": [
      {
        "dosha": "shrapit",
        "classicalStatus": "A modern name for Saturn with Rahu; not in the classical texts. The remedies are those of the two grahas.",
        "grahas": ["saturn", "rahu"],
        "details": ["Saturn + Rahu conjunct in Capricorn, house 5: Shrapit Dosha formed"],
        "specific": []
      }
    ]
  },
  "checked": {
    "grahas": [{ "graha": "mercury", "shadbalaVirupa": 405.77, "shadbalaRequired": 420, "sign": "Aries", "dignity": "neutral", "isCombust": false }],
    "doshas": { "mangal": true, "kaal-sarp": false, "shrapit": true, "grahan": true, "kemadruma": false, "sade-sati": false }
  },
  "disclaimer": "Traditional Jyotish practices, listed with their textual source for reference. Not a prediction, not a guarantee of any outcome..."
}
```

## Точність і джерела

- **Ґраха шанті**: BPHS, розд. 84 у 97-розділовій нумерації поширеного англійського тексту (розд. 86 у виданні Ґ.Ч. Шарми 2006 року), звірено з Яджнявалк'я-смріті, Ачарадх'яя 1.297-1.306. Матеріали зображень, ведичні мантри, самідх і дакшина збігаються в обох текстах за порядком. Джапа Марса - 11000 у цьому перекладі і 10000 у багатьох посібниках; повертаються обидва числа.
- **Прокляття і народження під час затемнення**: BPHS, розд. 83 і 91.
- **Рудракша**: божество кожної мукхі взято з Шіва-пурани (Відьєшвара-самхіта, розд. 25). Яка мукхі належить якій ґрасі - сучасна практика, не Пурана.
- **Не включено**, бо джерела не знайшлося: зерно кожної ґрахи, числа всередині янтр наваґрахи, день посту для Раху й Кету, стотри, приписані певним Пуранам без перевіреного посилання.

**Danger:**
**Довідка, а не порада.** Це традиційні практики з джерелами. Вони не є прогнозом, нічого не гарантують і не замінюють лікаря, психолога, юриста чи фінансового радника. Примітка є в кожній відповіді.

## Пов'язане

- [Ратна (камені)](/vedic/gemstones/), який камінь потрібен карті, за школою
- [Доші](/vedic/doshas/), детектори, які читає маршрут карти
- [Шадбала](/vedic/shadbala/), сила, на якій стоїть правило 1
- [Кредити](/credits/), повна таблиця цін