İçeriğe atla
GET/api/astro/ayanamsa_value/1 kredi

Ayanamsa değeri

Ayanamsa, ekinoksa bağlı tropikal zodyak ile Vedik astrolojide kullanılan ve yıldızlara bağlı olan sideral zodyak arasındaki farktır. Yılda yaklaşık elli yay saniyesi artar; bu yüzden her sideral hesaplama, hangi ayanamsayı ve hangi tarih için kullandığınıza bağlıdır. Bu endpoint yalnızca bu sayıyı döndürür. Sorgu parametreleriyle çalışan bir GET isteğidir: `ayanamsa`, LAHIRI, RAMAN, KRISHNAMURTI veya TRUE_CITRA gibi bir addır (47 standart ayanamsa tanımı, büyük/küçük harf ayrımı yapılmadan kabul edilir); `date` ise varsayılanı bugün olan bir ISO tarihidir. Bir haritayı hangi ayanamsayla hesaplandığını belirterek etiketlemek ya da belirli bir doğum tarihinde iki tanımın birbirinden ne kadar ayrıldığını görmek için kullanın. Yanıt değeri iki biçimde verir: altı ondalık basamaklı `value_degrees` ve `degrees`, `minutes`, `seconds` alanlarıyla birlikte hazır biçimlendirilmiş bir `formatted` string'i. Ad ve belirlenen tarih de yanıtta tekrarlanır. Bilinmeyen bir ad ve sözde ayanamsa 'USER' 400 döndürür.

https://api.occultapi.com/api/astro/ayanamsa_value/
İsteği deneyin

Kimlik doğrulama

Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.

X-API-Key: yt_live_a1b2c3d4_…

Sorgu parametreleri (2)

URL'de gönderilir. Aksi belirtilmedikçe hepsi isteğe bağlıdır ve birlikte kullanılabilir: önce filtreleme, sonra sayfalama, en son sıralama uygulanır.

ParametreTürÖrnekNe işe yarar
ayanamsastring—Ayanamsa adı (ör. LAHIRI). Varsayılan: LAHIRI.

GET sorgu parametresi. Büyük/küçük harfe duyarsızdır (değere .strip.upper uygulanır). Varsayılan: 'LAHIRI'. 'USER', efemeris motoru tanısa da bu endpoint tarafından açıkça reddedilir. Bilinmeyen değerler 400 {"error": "Unknown ayanamsa..."} döndürür.

şunlardan biri: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC
datestring—ISO tarih string'i (ör. 1990-05-14). Varsayılan: bugün.

BİÇİM kısıtı, enum değil. Python'daki datetime.fromisoformat'ın kabul ettiği her değer geçerlidir: 'YYYY-MM-DD' ya da tam bir ISO 8601 tarih-saat, ör. '1990-05-14' / '1990-05-14T12:30:00'. String'deki saat dilimi farkı YOK SAYILIR ve yerine UTC kullanılır. Varsayılan: bugün (UTC). Geçersiz biçim 400 döndürür.

Örnek istek

curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Yanıt

{
  "ayanamsa": "LAHIRI",
  "date": "2026-09-07",
  "value_degrees": 24.229844,
  "degrees": 24,
  "minutes": 13,
  "seconds": 47,
  "formatted": "24°13'47\""
}

Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.

Hatalar

Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.