Yöntem

Gezegen konumları NASA JPL efemeris verilerinden hesaplanır. Kısaltılmış bir sürüm değil, 105 MB'lık veri setinin tamamı kullanılır: 735 sabit yıldız, MS 500–2999 aralığı. Önceden hesaplanmış almanak değerlerinden oluşan bir tablodan aradeğerleme yapılmaz, önbelleğe alınmış sonuç da yoktur: her yanıt, istekteki tam an ve koordinatlar için hesaplanır.

Bu aralık iki gerçek durumda önem taşır: tarihî haritalar ile günümüzü onlarca yıl aşan uzun vadeli dasha ve transit taramaları. Yalnızca modern dönemle sınırlı bir kütüphane, bu sınırlarda fark ettirmeden hassasiyet kaybeder.

Ücretsiz panchang ve Jyotish sitemiz Yoga Panchang da aynı hesaplama motoruyla çalışır; yani okurlarının her gün gördüğü rakamlar burada anlatılan koddan gelir.

İki Vedik hesaplama arasındaki farkların en büyük kaynağı aritmetik değil, ayanamsadır. Hint gelenekleri bu konuda gerçekten ayrışır ve bir derecelik fark bir gezegeni bir nakshatra sınırının öbür yanına geçirir.

Bu yüzden 48 ayanamsa sunuyoruz: Surya Siddhanta ailesi, true Citra, true Revati, true Pushya, Raman, KP, Yukteshwar ve diğerleri. Her birini derece, dakika ve saniye düzeyinde düzeltebilirsiniz. Tek birini sunup doğrusu budur demiyoruz. Sonucumuz başka bir kaynakla uyuşmuyorsa ilk kontrol etmeniz gereken, ikinizin de aynı ayanamsayı kullanıp kullanmadığıdır.

Çoğu API dokümantasyonunun iddia edemeyeceği kısım bu. Referansımız elle yazılmaz: build_api_catalogue onu doğrudan serializer'lardan üretir, ardından verify_api_catalogue onu çalışan bir sunucuda sınar. Dokümante edilen her örnek isteği gönderir ve 2xx döndüğünü kontrol eder.

Sonuç, asıl değerli olan şeydir: 299 endpoint sayfasından 255 tanesi uydurma değil, gerçekten kaydedilmiş bir yanıt gösterir. Diğerleri çalışıyormuş gibi sunulmaz, henüz doğrulanmadı diye işaretlenir. Elle tutulan bir tablodaki gibi bir alanın dokümanlardan sessizce kayıp gitmesi mümkün değildir. Bir serializer değişir de dokümanlar yeniden üretilmezse doğrulama başarısız olur; yanlış bilgi yayımlanmaz.

OpenAPI tanımı, Postman koleksiyonu ve llms.txt de aynı katalogdan üretilir; yani dördü de yapıları gereği aynı API'yi anlatır.

Backend'de 87 modüle dağılmış 1.783 test fonksiyonu var. En yoğun test edilen kısım kredi düşme akışıdır, çünkü bir hata orada birinin parasına mal olur. Testler şunları doğrular: başarılı bir çağrı tam olarak endpoint'in ücreti kadar düşer; 4xx ve 5xx hiçbir şey düşmez; son kredi için eşzamanlı bir yarış bakiyeyi eksiye düşüremez; rastgele sırayla yapılan kredi yüklemeleri ve harcamalardan sonra hesap defteri bakiyeyle tutar.

62 ms medyan ve %76 oranında 100 ms altı yanıt yayımlıyoruz. Bu rakamlar, hızlı bir endpoint'i ölçüp yuvarlayarak değil, yayımlanan 254 örneği 22 Ekim 2026 tarihinde, her birini kendi örnek isteğiyle API'nin yerel bir kopyasında çağırarak elde edildi: önce bir kez ısınma için, sonra bir kez süresi ölçülerek. Yapay zekâ sohbeti dahil edilmedi: onun süresi dil modelinin süresidir.

Bu yüzden şunu da söylüyoruz: birkaç endpoint çok daha yavaştır ve dokümantasyonda da öyle yazar. Tam bir varshaphal taraması ya da bir yıllık raasi dasha milisaniyeler değil saniyeler sürer, çünkü bu bir sorgu değil bir taramadır. Medyan bunu gizler; dağılımı yanında yayımlamak gizlemez.

medyan   62 ms      endpoint'lerin yarısı bundan hızlı
<100ms   %76        sıradan sorguların büyük kısmı
yavaş    saniyeler   derin taramalar — referansta adlarıyla belirtilir

Yayımlamak istediğimiz ama henüz yayımlamadığımız iki şey var. Sizin tahmin etmenize bırakmak yerine açıkça söylüyoruz:

• Bağımsız bir konum karşılaştırması. JPL efemeris verileriyle hesaplıyoruz, ancak sonuçlarımızı çeşitli tarih ve gök cisimleri için JPL Horizons ile karşılaştıran, sapmaları ve bunları yeniden üretecek kodu içeren bir çalışmayı henüz yayımlamadık. Bunu yayımlayana kadar doğruluk iddiamızı “belirli bir toleransla doğrulandı” olarak değil, “bu kaynaktan hesaplandı” olarak okuyun.
• Uzun vadeli erişilebilirlik. Erişilebilirlik yalnızca Ekim 2026'dan beri durum sayfasında yayımlanıyor; bu yüzden aktarılabilecek uzun bir geçmiş henüz yok. Neleri taahhüt ettiğimizi şeffaflık sayfasında bulabilirsiniz.

İkisi de yapılacaklar listemizde. Hiçbiri zor değil; ikisi de yarım yamalak yapmaktansa doğru dürüst yapmak istediğimiz işler.

Playground kendi anahtarınızla gerçek çağrılar yapar ve başarısız çağrılar ücretsizdir. Sonuçlarımızı zaten güvendiğiniz kaynakla karşılaştırabilirsiniz. Ayanamsayla açıklayamadığımız bir fark bulursanız bunu duymak isteriz.