/api/astro/cazimi/1 krediCazimi, yanma ve ışınlar altında olma
Belirli bir anda her gezegen için Güneş'e bağlı üç durum. Güneş'e yakın bir gezegen üç durumdan birindedir; sürekli birbirine karıştırılsalar da bunlar aynı şey değildir. CAZIMI, Güneş'in merkezine yaklaşık 17 yay dakikası mesafededir — "kalbinde" — ve bir gezegenin olabileceği EN GÜÇLÜ hâl sayılır. YANIK, yaklaşık 8.5 derece içindedir ve en kötü duruma yakındır: gezegenin anlamları yanıp kül olur. IŞINLAR ALTINDA, yaklaşık 15 derece içindedir; gezegen zayıflamıştır ama etkisini yitirmemiştir. Bu ayrım önemlidir, çünkü cazimi ile yanık arasında yalnızca yarım derece vardır ve anlamları birbirinin tam tersidir; bu yüzden önce cazimi kontrol edilir — iki orb'un da içinde kalan gezegen cazimidir. Yalnızca yanmaya bakan bir endpoint, geleneksel astrolojideki en iyi yerleşimi en kötüsü olarak bildirirdi. Her gezegen için ayrıca şunlar döner: derece ve yay dakikası cinsinden kesin uzanım, gezegenin Güneş'in hangi tarafında olduğu ve Güneş'e yaklaşıyor mu yoksa ondan uzaklaşıyor mu olduğu. Sonuncusu iki boylam hızından türetilir ve yanmaya girmekte olan bir gezegeni yanmadan çıkmakta olandan ayırır. Kaynaklar bu konuda hemfikir olmadığından üç orb da istek alanı olarak ayarlanabilir. Bu endpoint, tek bir gezegenin yanık olduğu dönemleri bulmak için bütün bir yılı tarayan /api/astro/combustion/ endpoint'inden farklıdır: her gezegenin şu anki durumunu verir ve cazimi ile ışınlar altında olmayı da kapsar.
https://api.occultapi.com/api/astro/cazimi/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_…
Content-Type: application/jsonİstek alanları
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| date_time | string (date-time) | zorunlu | Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir. |
| altitude | number (double) | isteğe bağlı | GÖZLEMCİNİN metre cinsinden rakımı; bir cismin yüksekliği değildir. |
| cazimi_orb | number (double) | isteğe bağlı | Derece. Varsayılan: 0.2833, yani 17 yay dakikası. min 0 · max 5 |
| combust_orb | number (double) | isteğe bağlı | Derece. Varsayılan: 8.5. min 0 · max 30 |
| keys | array | isteğe bağlı | Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin. |
| latitude | number (double) | isteğe bağlı | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. min -89.9 · max 89.9 |
| longitude | number (double) | isteğe bağlı | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. min -180 · max 180 |
| planet_names | array | isteğe bağlı | Kontrol edilecek cisimler. Güneş ve düğümler gönderilse de yok sayılır. |
| time_zone | number (double) | isteğe bağlı | UTC farkı. Bunu ya da timezone_as_float alanını kullanın; ikisi aynı işi görür. min -12 · max 14 |
| timezone_as_float | number (double) | isteğe bağlı | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. min -12 · max 14 |
| under_beams_orb | number (double) | isteğe bağlı | Derece. Varsayılan: 15.0. min 0 · max 45 |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/cazimi/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-09T12:00:00+00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":0}'Yanıt
{
"data": {
"sun": {
"longitude": 166.834,
"longitude_speed": 0.971766
},
"orbs_used": {
"cazimi": 0.2833333333333333,
"combust": 8.5,
"under_the_beams": 15
},
"bodies": {
"MOON": {
"elongation_degrees": 21.277,
"elongation_arcminutes": 1276.62,
"side": "behind",
"condition": "none",
"cazimi": false,
"combust": false,
"under_the_beams": false,
"applying": true,
"longitude": 145.557,
"longitude_speed": 14.085813
},
"MERCURY": {
"elongation_degrees": 11.155,
"elongation_arcminutes": 669.3,
"side": "ahead",
"condition": "under_the_beams",
"cazimi": false,
"combust": false,
"under_the_beams": true,
"applying": false,
"longitude": 177.989,
"longitude_speed": 1.714265
},
"VENUS": {
"elongation_degrees": 42.61,
"elongation_arcminutes": 2556.6,
"side": "ahead",
"condition": "none",
"cazimi": false,
"combust": false,
"under_the_beams": false,
"applying": true,
"longitude": 209.444,
"longitude_speed": 0.671018
},
"MARS": {
"elongation_degrees": 58.102,
"elongation_arcminutes": 3486.12,
"side": "behind",
"condition": "none",
"cazimi": false,
"combust": false,
"under_the_beams": false,
"applying": false,
"longitude": 108.732,
"longitude_speed": 0.62136
},
"JUPITER": {
"elongation_degrees": 31.375,
"elongation_arcminutes": 1882.5,
"side": "behind",
"condition": "none",
"cazimi": false,
"combust": false,
"under_the_beams": false,
"applying": false,
"longitude": 135.459,
"longitude_speed": 0.203527
},
"SATURN": {
"elongation_degrees": 153.673,
"elongation_arcminutes": 9220.38,
"side": "behind",
"condition": "none",
"cazimi": false,
"combust": false,
"under_the_beams": false,
"applying": false,
"longitude": 13.161,
"longitude_speed": -0.065826
}
},
"notes": {
"order": "Cazimi is tested first: its orb lies inside the combust orb, and a planet inside both is cazimi, which the tradition reads as the strongest placement rather than the weakest."
}
},
"status": 200,
"is_error": false,
"message": "successful"
}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.