Vedic FAQ

Zebraliśmy pytania, które często pojawiają się przy integracji endpointów wedyjskich. Jeśli nie znalazłeś odpowiedzi, napisz na hello@astroway.info, a ją dodamy.

Jakie ayanamsy są obsługiwane? Którą wybrać?

API obsługuje 9 ayanams:

Kod	Nazwa	Kiedy wybrać
`lahiri` (default)	Chitra Paksha	Standard rządu Indii; największy rynek masowy. Dla większości aplikacji wedyjskich to właśnie ta.
`raman`	B.V. Raman	Jeśli integrujesz aplikację mobilną na rynek południowoindyjski (Karnataka, Tamil Nadu).
`krishnamurti` (alias `kp`)	KP	Jeśli wywołujesz `/v1/vedic/kp/*` - KP ma własną ayanamsę.
`yukteshwar`	Sri Yukteshwar	Odległość od Spiki; odbiorcy teozoficzni lub skłaniający się ku Zachodowi.
`fagan-bradley`	Fagan/Bradley	Zachodnia syderyczna (nie wedyjska). Dla astrologów przechodzących z syderycznych tradycji zachodnich.
`de-luce`	De Luce	Starszy wybór astrologów, rzadki.
`jn-bhasin`	JN Bhasin	Specyficzna szkoła, rzadka.
`true-citra`	True Chitra Paksha	Spika sztywno na 0° Wagi. Od Lahiri różni się o 0,01°, więc wybieraj ją tylko wtedy, gdy potrzebujesz właśnie powiązania z gwiazdą.
`djwhal-khul`	Djwhal Khul	Szkoła teozoficzna, rzadka. Największe odchylenie w tabeli.

Główne szkoły różnią się niewiele: Lahiri, True Chitra i KP mieszczą się w 0,1°, Fagan/Bradley, JN Bhasin, Yukteshwar i Raman - do 1,45°. Na uboczu stoją De Luce (3,96° od Lahiri) i Djwhal Khul (3,82°), przy których pozycja blisko granicy znaku przechodzi już do sąsiedniego znaku. Zmierzono 2026-08-18 na Księżycu jednego horoskopu; w technikach opartych na stopniach (pozycja w nakshatrze, Argala) różnicę widać nawet w granicach 0,1°.

Sidereal czy tropical? Co zwraca API?

Domyślnie endpointy wedyjskie zwracają pozycje syderyczne (zodiak powiązany z gwiazdami, z zastosowaną ayanamsą). Endpointy zachodnie (/v1/chart, /v1/synastry) zwracają pozycje tropikalne (zodiak powiązany z punktem równonocy).

Tropikalnej astrologii wedyjskiej (rzadki przypadek brzegowy, proponowany przez Sanjaya Ratha i Ernsta Wilhelma) API nie zwraca: wszystkie endpointy wedyjskie liczą syderycznie i ignorują zodiacType w treści zapytania. Pozycje tropikalne daje gałąź zachodnia (/v1/chart, /v1/synastry), a zodiacType: "sidereal" przełącza ją na zodiak syderyczny z tą samą ayanamsą.

Której szkoły kiedy używać?

Szkoła	Region / odbiorcy	Mocna strona
Parashara (BPHS)	Cały świat wedyjski - uniwersalna baza	Najpełniejszy korpus technik; zawsze zaczynaj tutaj
Jaimini	Tamil Nadu + zaawansowani praktycy	Prognozy oparte na karakach; tematy życiowe wyznaczane przez AK
Lal Kitab	Pendżab + północne Indie	Unikalne remedia (upaye), specyfika Manglik
KP (Krishnamurti)	Tamil Nadu + Andhra Pradesh	Sub-lord theory, precyzja w timingu wydarzeń

Pratyangira, AstroSage i inne duże API dają głównie Parasharę. AstroWay obejmuje wszystkie cztery przez osobne grupy endpointów.

Ashtakoot czy Dashakoota: na który rynek?

	Ashtakoot	Dashakoota
Region	Północne/środkowe Indie, Pakistan, Nepal	Południowe Indie (Tamil Nadu, Karnataka, Kerala)
Skala	Maks. 36 punktów	10 kut (czynników)
Składniki	Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi	Dina + Gana + Mahendra + Stri-Dirgha + Yoni + Rashi + Rashi-adhipati + Vashya + Rajju + Vedha
API	`/v1/vedic/compatibility/ashtakoot`	`/v1/vedic/compatibility/dashakoota`

Jeśli serwis kojarzenia par obsługuje całe Indie, wywołaj /v1/vedic/compatibility/full - dostaniesz oba + Manglik + Bhrigu.

Mangal Dosha: dlaczego to ważne?

Mangal Dosha = Mars w 1/2/4/7/8/12 domu od Lagny, Księżyca lub Wenus (różne szkoły interpretują to różnie). W Indiach to przeszkoda dla małżeństwa: jeśli oboje partnerzy mają afliktowanego Marsa bez kompensacji, tradycyjny astrolog nie da zielonego światła bez upayas (remediów) lub czynników kompensujących.

Endpoint API: /v1/vedic/compatibility/manglik-check - zwraca { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }.

D9 (Navamsha) - dlaczego to najważniejsza varga?

D9 = podział każdego znaku na 9 części = szczegółowy horoskop “na poziomie duszy”. W astrologii wedyjskiej używa się go do:

Prognoz małżeńskich: Wenus + władca 7. domu w D9 pokazują prawdziwą naturę życia małżeńskiego
Siły planet: planeta silna w D1, ale słaba w D9 = “obiecuje, ale nie spełnia”
Vargottama: planeta w tym samym znaku w D1 i D9 = szczególna siła

API: /v1/vedic/vargas zwraca wszystkie 16 podziałów w jednym wywołaniu; przy funkcjach związanych z małżeństwem i relacjami skup się na D9.

Dlaczego godzina urodzenia jest krytyczna? Co zrobić, gdy jest nieznana?

Astrologia wedyjska jest bardzo wrażliwa na czas:

Lagna (Ascendent) zmienia się co ~2 godziny: przesuwa się WTEDY cały horoskop
Nakshatra Księżyca zmienia się co 6–8 godzin
Dasha balance (okres początkowy) zależy od pozycji Księżyca w nakshatrze

Jeśli dokładna godzina jest nieznana:

Sunrise chart: użyj godziny wschodu Słońca w miejscu urodzenia jako przybliżenia. Słońce stoi wtedy na Ascendencie, więc Lagna w przybliżeniu pokrywa się ze znakiem Słońca; część astrologów wedyjskich uważa sunrise charts za wiarygodne przy prognozie ogólnych tendencji
Rektyfikacja: wywołaj /v1/rectification z 2-3 znanymi wydarzeniami życiowymi (ślub, dziecko, zmiana pracy) - API zwraca prawdopodobne okno godziny urodzenia
Zastrzeżenie dla użytkownika: poinformuj, że wyniki przy nieznanej godzinie to przybliżenie, a nie dokładny horoskop

Jakie systemy domów są używane?

Astrologia wedyjska tradycyjnie używa domów Whole Sign (cały znak = jeden dom). Zachodnia - Placidus / Koch / Equal itd.

Domyślnie AstroWay dla astrologii wedyjskiej = Whole Sign. Dla endpointów KP - Placidus (konwencja KP). Przekaż parametr houseSystem, jeśli potrzebujesz innego: whole-sign, placidus, koch, equal, porphyry.

Czy można łączyć astrologię wedyjską i zachodnią w jednej aplikacji?

Tak - i jest to wręcz zalecane dla odbiorców wielu tradycji. Architektura:

Horoskop urodzeniowy liczony jest raz: endpointy zachodnie i wedyjskie mają ten sam input (date/time/lat/lon)
Dodaj w UI przełącznik “Western view” / “Vedic view”
Wedyjski znak Księżyca (rashi) często myli się z zachodnim znakiem Słońca: uprzedź użytkownika o różnicy
Zgodność: możesz pokazać OBIE naraz: zachodnią synastrię + wedyjski Ashtakoot

Endpoint API /v1/compat/astro-vedic robi to automatycznie - most między zachodnią synastrią a wedyjskim Ashtakoot.

Jakie efemerydy są używane? Jak dokładne?

Swiss Ephemeris (LGPL) - te same co w Solar Fire, Kepler, Astro Gold, Janus, AstroSeek. Dokładność:

Pozycje planet: ±1 sekunda łuku względem efemeryd NASA JPL
Wierzchołki domów: ±1 minuta łuku
Ayanamsa: tabela Lahiri sprawdzona krzyżowo z oficjalnymi tabelami rządu Indii

Obliczenia specyficzne dla astrologii wedyjskiej (pozycja w nakshatrze, balans Vimshottari, vargi) są sprawdzone krzyżowo z PyJHora (de facto referencja w Pythonie); rozbieżności, tam gdzie są, < 0,01°. Raport rozbieżności - docs/AUDIT-TRAIL.md w repozytorium.

Czy mogę zapisywać wyniki w cache? Jak?

Tak - większość endpointów wedyjskich jest deterministyczna dla tego samego inputu horoskopu. Stabilny klucz cache: hash(date + time + lat + lon + ayanamsa + endpoint).

API oferuje też nagłówek X-Idempotency-Key - 5-minutowy cache po stronie api-calc. Przy cache hit kredyty nie są pobierane.

Jak lokalizowane są teksty w odpowiedziach?

Endpointy wedyjskie zwracające interpretacje (opisy jog, znaczenia dosh, uzasadnienia muhurt) przyjmują parametr lang. Obsługa: 20 języków (T0 - uk/en/de/ru ręcznie; T1 - pl/es/pt/hi/fr/ko AI Beta; T2/T3 - planowane). Szczegóły: /languages/.

Jeśli endpoint zwraca dane liczbowe (stopnie, daty, indeksy znaków), są one niezależne od języka. Pola tekstowe (note, meaning, manifestation) są lokalizowane.

Co zrobić ze statusem YELLOW?

YELLOW = endpoint działa, ale ma jedną z trzech cech:

Szkoła jednego autora (Lal Kitab, KP): brak weryfikacji krzyżowej z innymi szkołami, bo takie nie istnieją
Oparty na scoringu/heurystyce (compatibility 0-100, breakup-timing): ocena liczbowa jest z natury subiektywna
Wewnętrzny limit precyzji (rektyfikacja, Bhrigu match): algorytm ma wbudowany próg dokładności

Sprawdź docs/AUDIT-TRAIL.md dla konkretnego endpointu - jest tam napisane dlaczego YELLOW i czy istnieje droga do GREEN. W większości przypadków nie (ograniczenie wewnętrzne) i jest to uczciwe zastrzeżenie dla integratora.