POST/api/astro/transit/solar-ingress/1 kredi

Güneş girişi

Güneş'in belirli bir ekliptik boylama bir dahaki sefere ne zaman ulaşacağı. Tüm Güneş girişi sorularının arkasındaki hesaplama: Koç girişi için 0, Yengeç için 90, Terazi için 180, Oğlak için 270 ya da istediğiniz herhangi bir dereceyi gönderin. Koç'un 0 derecesini geçmek mart ekinoksu DEMEKTİR; bu endpoint /api/astro/seasons/ ile aynı anı döndürür. Yalnızca ileriye doğru arama yapılır. Motorun geriye doğru araması güvenilir değildir: 0 derecelik hedef için ileri aramayla aynı tarihi, 90 derece için ise bir yıl sonraki bir tarihi döndürür. Bu yüzden sunulmaz. Hindu takviminde kullanılan SİDERAL Sankranti tarihlerini veren /api/astro/sankranti/ endpoint'inden farklıdır. İkisi arasındaki fark ayanamsa kadardır.

https://api.occultapi.com/api/astro/transit/solar-ingress/

İ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_…
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.
celestial	string	isteğe bağlı	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial1	string	isteğe bağlı	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial2	string	isteğe bağlı	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
datetime_end	string (date-time)	isteğe bağlı
datetime_start	string (date-time)	isteğe bağlı
degr	number (double)	isteğe bağlı	min 0 · max 360
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 -90 · max 90
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	string	isteğe bağlı	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
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
tz	number (double)	isteğe bağlı	Döndürülen zamanların ifade edildiği UTC farkı. min -12 · max 14
when	string	isteğe bağlı	Yalnızca ileri yönde; `before` için modül docstring'ine bakın. `after`
x2cross	number (double)	isteğe bağlı	Geçilecek ekliptik boylam, 0 Koç'tan itibaren 0-360. min 0 · max 360

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/transit/solar-ingress/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2025-01-01T00:00:00+00:00","tz":0,"when":"after","x2cross":0}'

Yanıt

{
  "data": {
    "body": "sun",
    "target_longitude": 0,
    "direction": "after",
    "crossing": "2025-03-20T09:01:29Z"
  },
  "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.