Ratna (kamienie-remedia)

Ratna (रत्न) to kamień-remedium dla planety. Dziewięć kamieni, navaratna, po jednym na każdą z dziewięciu grah. Pytanie “jaki kamień mam nosić” brzmi prosto, ale odpowiedź zależy od szkoły, a dwie popularne szkoły dają różne zakazy. Dlatego /v1/vedic/gemstones przyjmuje szkołę jako parametr, a w odpowiedzi zawsze podaje, według której liczył.

Dwie szkoły

Szkoła	Co zaleca	Czego zakazuje
lagna-lord (domyślnie)	Kamienie władców 1., 9. i 5. domu: kamień życiowy, szczęśliwy i dobroczynny	Prawie nic: tylko grahę, która włada wyłącznie dusthanami
functional-benefic	Te same trzy kamienie, ale jako pierwsza idzie yogakaraka, jeśli jest	Kamienie wszystkich funkcjonalnych malefików dla tej lagny

Zalecane kamienie w obu szkołach są te same, i to nie przypadek: funkcjonalny benefik to z definicji graha władająca trikoną, a władcy trikon to właśnie władcy 1, 5 i 9. Nie założyliśmy tego, tylko sprawdziliśmy przebiegiem po wszystkich dwunastu lagnach i przypięliśmy testem.

Różnica leży tam, gdzie ma znaczenie dla kupującego: w liście zakazów. Dla lagny w Lwie functional-benefic wyklucza szmaragd, diament i niebieski szafir, a lagna-lord żadnego z nich. Jeśli twój astrolog pracuje w jednej szkole, a ty oddasz klientowi odpowiedź drugiej, rozbieżność pojawi się właśnie tutaj.

Endpointy

Endpoint	Kredyty	Co zwraca
POST /v1/vedic/gemstones	20	Rekomendacja według horoskopu: trzy kamienie z rolą, lista zakazów, zastrzeżenie, stan planet
GET /v1/vedic/gemstones/navaratna	5	Tabela referencyjna dziewięciu kamieni bez horoskopu

Uwaga

Współrzędne są obowiązkowe. Cała odpowiedź wynika z lagny, więc latitude i longitude nie mają tu domyślnego zera, jak w pozostałych endpointach chart: bez nich dostaniesz 400, a nie pewny siebie zestaw kamieni dla cudzego ascendentu.

Przykład

cURL

curl -X POST https://api.astroway.info/v1/vedic/gemstones \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "school": "functional-benefic"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/gemstones', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-05-15', time: '14:30:00', timezoneOffset: 3,
    latitude: 50.45, longitude: 30.52, school: 'functional-benefic',
  }),
});
const { data } = await r.json();
console.log(`Lagna ${data.lagna.signName}, school ${data.school}`);
for (const g of data.recommended) console.log(`  ${g.role}: ${g.gem}`);
for (const g of data.avoid) console.log(`  avoid ${g.gem} (${g.basis})`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/gemstones',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3,
        'latitude': 50.45, 'longitude': 30.52, 'school': 'functional-benefic',
    },
)
d = r.json()['data']
print(f"Lagna {d['lagna']['signName']} ({d['school']})")
for g in d['recommended']:
    w = g['wearing']
    print(f"  {g['gem']:16s} {w['day']:10s} {w['finger']:14s} {w['minWeight']['carats']} ct")

Przykład odpowiedzi

{
  "type": "gemstone-recommendation",
  "school": "functional-benefic",
  "ayanamsa": 23.7225,
  "lagna": { "sign": 4, "signName": "Leo", "lord": 0, "lordName": "Sun" },
  "recommended": [
    {
      "role": "yogakaraka (primary)",
      "graha": 4, "grahaName": "Mars",
      "gem": "Red coral", "gemSanskrit": "Moonga",
      "mineral": "Corallium rubrum",
      "housesOwned": [4, 9],
      "basis": "owns the 4th (kendra) and the 9th (trikona)",
      "substitutes": ["Carnelian", "Red jasper"],
      "wearing": {
        "day": "Tuesday",
        "finger": "Ring finger",
        "metals": ["Gold", "Copper"],
        "minWeight": { "ratti": [6, 9], "grams": [0.729, 1.094], "carats": [3.65, 5.47] },
        "mantra": "Om Kraam Kreem Kraum Sah Bhaumaya Namah",
        "japaCount": 10000
      }
    }
  ],
  "avoid": [
    { "gem": "Blue sapphire", "basis": "owns the 6th and no trikona" },
    { "gem": "Emerald", "basis": "owns the 11th and no trikona" }
  ],
  "condition": {
    "Sun": { "signName": "Taurus", "house": 10, "dignity": "neutral", "isCombust": false }
  },
  "disclaimer": "Traditional Jyotish remedy, informational only..."
}

Co dokładnie jest zwracane

• basis przy każdym kamieniu to nie etykieta, tylko ślad rozumowania: którymi domami włada graha i dlaczego daje to taką rolę. Rekomendację można sprawdzić, nie wierząc nam na słowo.
• wearing: dzień, palec, metale, waga w ratti z przeliczeniem na gramy i karaty, bija-mantra i liczba jap. Waga podana jest jako zakres, a palec jako lista wariantów, bo podręczniki się różnią.
• substitutes (upa-ratna): w praktyce alternatywą dla naturalnego niebieskiego szafiru o masie 5 karatów nie jest “brak remedium”, tylko tańszy zamiennik. Kto liczy koszt rekomendacji, powinien widzieć oba warianty.
• condition: godność, spalenie, retrogradacja każdej grahy. To kontekst, a nie reguła: obie szkoły przypisują kamienie według władania domami, a twierdzić inaczej znaczyłoby wymyślić trzecią szkołę.
• nodesNote: Rahu i Ketu nie władają żadnym znakiem, więc od lagny do hesonitu (gomed) i kociego oka nie dojdzie żadna ze szkół. Piszemy to wprost, zamiast po cichu zwracać siedem kamieni z dziewięciu.

Dokładność i źródła

• Przyporządkowanie kamienia do grahy: Garuda Purana (Acharakhanda, rozdział ratna-pariksha) i Varahamihira, Brihat Samhita, rozdz. 80. Oba teksty podają ten sam zestaw dziewięciu kamieni.
• Reguła trzech kamieni (życiowy, szczęśliwy, dobroczynny) to standardowa współczesna praktyka.
• Klasyfikacja funkcjonalna: Bepin Behari, Fundamentals of Vedic Astrology. Sama reguła yogakaraki pochodzi z BPHS: graha, która włada zarówno kendrą, jak i trikoną.
• Jak to sprawdzono. To nie jest technika liczbowa, więc nie ma tu czego odnosić do efemeryd. Możliwa jest jedna weryfikacja: reguły muszą odtwarzać opublikowane przypisania, nigdzie ich nie zaszywając. Klasyczna szóstka yogakarak (Saturn dla Byka i Wagi, Mars dla Raka i Lwa, Wenus dla Koziorożca i Wodnika) wynika sama z reguły władania, podobnie jak znane listy zakazów dla Barana, Byka, Raka i Lwa. Każde z tych twierdzeń to test.
• Lagna jest syderyczna, wyprowadzona przez ayanamsę. Tropikalny ascendent jest zwykle przesunięty o cały znak, co zmieniłoby każdy kamień w odpowiedzi.
• Protokół noszenia (dzień, palec, metal, waga, mantra) to współczesna praktyka, a nie shastra. Dlatego warianty i zakres, a nie jedna liczba podana jako kanon.

Ważne

To remedium, a nie medycyna ani ocena zakupu. Tożsamość kamienia, jego obróbkę i wagę musi przed zakupem potwierdzić wykwalifikowany gemmolog lub jubiler. Żaden kamień nie zastępuje leczenia: z każdym pytaniem o zdrowie zwróć się do lekarza. To zastrzeżenie jest w każdej odpowiedzi endpointu.

Powiązane

• Shadbala, siła planety, jeśli potrzebujesz nie spojrzenia przez remedia, lecz ilościowego
• Doshe, Mangal, Kaal Sarp i inne aflikcje, pod które tradycyjnie dobiera się kamień
• Vargi, horoskopy dywizyjne
• Kredyty, pełna tabela kosztów
• Uwierzytelnianie, jak zdobyć klucz aw_live_*