Vedik SSS

Vedik endpoint’leri entegre ederken sık sorulan soruları burada topladık. Cevabı bulamadıysanız hello@astroway.info adresine yazın, ekleyelim.

Hangi ayanamsa’lar destekleniyor? Hangisini seçmeli?

API 9 ayanamsa destekler:

Kod	Ad	Ne zaman seçilir
`lahiri` (default)	Chitra Paksha	Hindistan hükümetinin standardı; en büyük kitle pazarı. Çoğu Vedik uygulama için doğru seçim budur.
`raman`	B.V. Raman	Güney Hindistan pazarı (Karnataka, Tamil Nadu) için bir mobil uygulama entegre ediyorsanız.
`krishnamurti` (takma adı `kp`)	KP	`/v1/vedic/kp/*` çağırıyorsanız: KP’nin kendi ayanamsa’sı vardır.
`yukteshwar`	Sri Yukteshwar	Spica’ya uzaklık; teosofik veya Batı’ya yakın kitleler.
`fagan-bradley`	Fagan/Bradley	Batı sidereal (Vedik değil). Sidereal Batı geleneklerinden gelen astrologlar için.
`de-luce`	De Luce	Eski bir astrolog tercihi, nadir.
`jn-bhasin`	JN Bhasin	Belirli bir okul, nadir.
`true-citra`	True Chitra Paksha	Spica tam olarak Terazi 0°‘de sabitlenir. Lahiri’den 0,01° ayrılır; yani yalnızca özellikle yıldıza bağlı bir referans gerekiyorsa seçin.
`djwhal-khul`	Djwhal Khul	Teosofik okul, nadir. Tablodaki en büyük sapma.

Ana okullar arasındaki fark küçüktür: Lahiri, True Chitra ve KP 0,1° içinde kalır; Fagan/Bradley, JN Bhasin, Yukteshwar ve Raman 1,45°‘ye kadar ayrılır. De Luce (Lahiri’den 3,96°) ve Djwhal Khul (3,82°) ayrı durur: bunlarda burç sınırına yakın bir konum komşu burca geçer. 2026-08-18’de tek bir haritanın Ay’ı üzerinden ölçülmüştür; derece temelli tekniklerde (Nakshatra konumu, Argala) fark 0,1° içinde bile görünür.

Sidereal mı tropikal mi? API ne döndürür?

Vedik endpoint’ler varsayılan olarak sidereal konumlar döndürür (zodyak yıldızlara bağlıdır, ayanamsa uygulanmıştır). Batı endpoint’leri (/v1/chart, /v1/synastry) tropikal konumlar döndürür (zodyak ekinoks noktasına bağlıdır).

Tropikal Vedik (Sanjay Rath ve Ernst Wilhelm’in önerdiği nadir bir uç durum) API tarafından sunulmaz: tüm Vedik endpoint’ler sidereal hesaplar ve istek gövdesindeki zodiacType alanını yok sayar. Tropikal konumları Batı dalı (/v1/chart, /v1/synastry) verir; zodiacType: "sidereal" ise onu aynı ayanamsa ile sidereal zodyağa geçirir.

Hangi okul ne zaman kullanılır?

Okul	Bölge / Kitle	Güçlü yanı
Parashara (BPHS)	Tüm Vedik dünya, evrensel temel	En eksiksiz teknik külliyatı; her zaman buradan başlayın
Jaimini	Tamil Nadu + ileri düzey uygulayıcılar	Karaka temelli öngörüler; AK’nin yönlendirdiği yaşam temaları
Lal Kitab	Punjab + Kuzey Hindistan	Kendine özgü çareler (upaya), Manglik’e özgü yorum
KP (Krishnamurti)	Tamil Nadu + Andhra Pradesh	Sub-lord teorisi, olay zamanlamasında hassasiyet

Pratyangira, AstroSage ve diğer büyük API’ler çoğunlukla yalnızca Parashara sunar. AstroWay ayrı endpoint gruplarıyla dördünü de kapsar.

Ashtakoot mu Dashakoota mı: hangi pazar için?

	Ashtakoot	Dashakoota
Bölge	Kuzey/Orta Hindistan, Pakistan, Nepal	Güney Hindistan (Tamil Nadu, Karnataka, Kerala)
Ölçek	En fazla 36 puan	10 koota (faktör)
Bileşenler	Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi	Dina + Gana + Mahendra + Stree-Deergha + Yoni + Rasi + Rasyadhipati + Vashya + Rajju + Vedha
API	`/v1/vedic/compatibility/ashtakoot`	`/v1/vedic/compatibility/dashakoota`

Eşleştirme servisiniz tüm Hindistan’a hizmet veriyorsa /v1/vedic/compatibility/full çağırın: ikisini birden + Manglik + Bhrigu alırsınız.

Mangal Dosha: neden önemli?

Mangal Dosha = Mars’ın Lagna’dan, Ay’dan veya Venüs’ten 1/2/4/7/8/12. evde olması (okullar farklı yorumlar). Hindistan’da bu, evlilik için bir engeldir: iki partnerde de telafi edilmemiş bir Mangal etkilenmesi varsa, geleneksel bir astrolog upaya’lar (çareler) veya dengeleyici faktörler olmadan onay vermez.

API endpoint’i: /v1/vedic/compatibility/manglik-check, { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... } döndürür.

D9 (Navamsha): neden en önemli varga?

D9 = her burcun 9’a bölünmesi = ayrıntılı, “ruh düzeyinde” bir harita. Vedik astrolojide şunlar için kullanılır:

Evlilik öngörüleri: D9’daki Venüs + 7. ev yöneticisi evlilik hayatının gerçek doğasını gösterir
Gezegen gücü: D1’de güçlü ama D9’da zayıf bir gezegen = “gösterir ama vermez”
Vargottama: D1 ve D9’da aynı burçtaki gezegen = özel güç

API: /v1/vedic/vargas tek çağrıda 16 bölümün hepsini döndürür; evlilik ve ilişkiyle ilgili özellikler için D9’a odaklanın.

Doğum saati neden kritik? Bilinmiyorsa ne yapmalı?

Vedik astroloji zamana çok duyarlıdır:

Lagna (Yükselen) yaklaşık her 2 saatte bir değişir: haritanın TAMAMI kayar
Ay’ın nakshatra’sı her 6–8 saatte bir değişir
Dasha bakiyesi (başlangıç dönemi) Ay’ın nakshatra konumuna bağlıdır

Kesin saat bilinmiyorsa:

Gün doğumu haritası: yaklaşık değer olarak doğum yerindeki gün doğumu saatini kullanın. Güneş bu durumda Yükselen üzerinde olur, dolayısıyla Lagna kabaca Güneş burcuyla örtüşür; bazı Vedik astrologlar gün doğumu haritalarını genel eğilim tahmini için geçerli sayar
Rektifikasyon: bilinen 2-3 yaşam olayıyla (evlilik, çocuk, iş değişikliği) /v1/rectification çağırın: API olası doğum saati aralığını döndürür
Kullanıcıya uyarı: bilinmeyen saatle elde edilen sonuçların kesin bir harita değil, yaklaşık değer olduğunu belirtin

Hangi ev sistemleri kullanılır?

Vedik astroloji geleneksel olarak Whole Sign evleri kullanır (burcun tamamı = bir ev). Batı astrolojisi Placidus / Koch / Equal vb. kullanır.

AstroWay’in Vedik varsayılanı = Whole Sign. KP endpoint’leri için Placidus (KP geleneği). Başka bir sistem gerekiyorsa houseSystem parametresini gönderin: whole-sign, placidus, koch, equal, porphyry.

Vedik ve Batı astrolojisi tek uygulamada karıştırılabilir mi?

Evet, çok gelenekli kitleler için bu önerilen yoldur. Mimari:

Doğum haritası bir kez hesaplanır: Batı ve Vedik endpoint’ler aynı girdiyi (date/time/lat/lon) paylaşır
Arayüzünüzde “Batı görünümü” / “Vedik görünümü” geçişi gösterin
Vedik Ay burcu (rashi) sıklıkla Batı Güneş burcuyla karıştırılır: kullanıcıyı farka karşı uyarın
Uyum: İKİSİNİ BİRDEN gösterebilirsiniz: Batı sinastrisi + Vedik Ashtakoot aynı anda

/v1/compat/astro-vedic API endpoint’i bunu otomatik yapar: Batı sinastrisi × Vedik Ashtakoot köprüsü.

Hangi efemeris kullanılıyor? Ne kadar doğru?

Swiss Ephemeris (LGPL): Solar Fire, Kepler, Astro Gold, Janus, AstroSeek’te kullanılanın aynısı. Doğruluk:

Gezegen konumları: NASA JPL efemerisine göre ±1 yay saniyesi
Ev başlangıçları: ±1 yay dakikası
Ayanamsa: Lahiri tablosu, Hindistan hükümetinin resmi tablolarına karşı çapraz doğrulanmıştır

Vedik’e özgü hesaplamalar (Nakshatra konumu, Vimshottari bakiyesi, Varga’lar) PyJHora’ya (fiili standart Python referansı) karşı çapraz kontrol edilmiştir; farklar, olduğu yerlerde, < 0,01°. Farklılık raporu: depodaki docs/AUDIT-TRAIL.md.

Sonuçları önbelleğe alabilir miyim? Nasıl?

Evet: Vedik endpoint’lerin çoğu aynı harita girdisi için deterministiktir. Kararlı önbellek anahtarı: hash(date + time + lat + lon + ayanamsa + endpoint).

API ayrıca X-Idempotency-Key başlığını sunar: api-calc tarafında 5 dakikalık önbellek. Önbellek isabetinde krediler düşülmez.

Yanıtlardaki metinler nasıl yerelleştiriliyor?

Yorum döndüren Vedik endpoint’ler (yoga açıklamaları, dosha anlamları, muhurat gerekçeleri) lang parametresini kabul eder. Destek: 20 dil (T0: uk/en/de/ru elle; T1: pl/es/pt/hi/fr/ko AI Beta; T2/T3: planlanıyor). Ayrıntılar: /languages/.

Endpoint sayısal veri (dereceler, tarihler, burç indeksleri) döndürüyorsa bunlar dilden bağımsızdır. Metin alanları (note, meaning, manifestation) yerelleştirilir.

YELLOW statüsüyle ne yapmalı?

YELLOW = endpoint çalışıyor, ancak şu üç özellikten birine sahip:

Tek yazarlı okul (Lal Kitab, KP): başka okullarla çapraz doğrulama yok, çünkü böyle okullar yok
Puanlama/sezgisel temelli (0-100 uyum, breakup-timing): sayısal değerlendirme doğası gereği özneldir
İçsel hassasiyet sınırı (rektifikasyon, Bhrigu match): algoritmanın doğal bir hassasiyet tabanı vardır

Belirli bir endpoint için docs/AUDIT-TRAIL.md dosyasına bakın: orada neden YELLOW olduğu ve GREEN’e bir yol olup olmadığı yazar. Çoğu için yoktur (içsel sınır) ve bu, entegratör için dürüst bir uyarıdır.