POST/api/astro/transit/1 kredi

Transit geçişleri

Bu endpoint belirli bir andaki haritayı tanımlamaz, anları arar. Şu tür soruları yanıtlar: Güneş Koç'un 0 derecesine bir dahaki sefere ne zaman ulaşacak, Mars iki tarih arasında belirli bir dereceyi ne zaman geçecek, Satürn ile Güneş bir dahaki sefere ne zaman aynı ekliptik boylamda olacak ve bir gök cismi belirli bir anda tam olarak nerede. Anahtarlardan ikisi hesaplama değil, mod değiştiricidir. `set_default_transit` düz tropikal efemerisi, `set_sidereal_transit` ise sideral efemerisi seçer; ikisi de null döndürür. İstekteki anahtarlar listelediğiniz sırayla işlenir; bu yüzden sonraki aramaların sideral olmasını istiyorsanız mod değiştiriciyi başa koyun. `planet`, `celestial`, `celestial1` ve `celestial2` alanları büyük harfli efemeris adlarını kullanır (`SUN`, `MOON`, `MEAN_NODE`, `TRUE_NODE`, `CHIRON`, Uranyen noktalar ve birkaç gezegen uydusu); bu adlar, buradaki çoğu endpoint'te kullanılan `Sun`/`Moon` adlarından farklıdır. `tz`, dönen tüm zaman damgalarına uygulanan, saat cinsinden düz bir farktır; `when`, aramanın referans zamandan sonra ('after') mı önce ('before') mı yapılacağını seçer; `datetime_start`/`datetime_end` ise `planet_transit` için arama aralığını sınırlar.

https://api.occultapi.com/api/astro/transit/

İsteği deneyin

Transit geçişleri çıktısı bir arayüzde — Bu endpoint'in verileri, canlı bir arayüzde. Değerleri API verir; ekran düzenini siz kurarsınız.

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.
datetime_end	string (date-time)	zorunlu
datetime_start	string (date-time)	zorunlu
keys	array	zorunlu	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.
planet	string	zorunlu	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 10 gezegeni, iki Ay düğümünü, 6 asteroidi, 9 Uranyen/kurgusal gök cismini ve 9 gezegen uydusunu kapsayan 36 kabul edilen değer. Tanınmayan bir ad hata vermez, sessizce None değerine eşlenir ve ardından efemeris motorunun derinlerinde hataya yol açar. Düğümler için alt çizgili MEAN_NODE / TRUE_NODE biçimleri kullanılır ('RAHU'/'KETU' takma adı yoktur).
tz	number (double)	zorunlu	min -12 · max 14
celestial	string	isteğe bağlı	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 10 gezegeni, iki Ay düğümünü, 6 asteroidi, 9 Uranyen/kurgusal gök cismini ve 9 gezegen uydusunu kapsayan 36 kabul edilen değer. Tanınmayan bir ad hata vermez, sessizce None değerine eşlenir ve ardından efemeris motorunun derinlerinde hataya yol açar. Düğümler için alt çizgili MEAN_NODE / TRUE_NODE biçimleri kullanılır ('RAHU'/'KETU' takma adı yoktur).
celestial1	string	isteğe bağlı	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 10 gezegeni, iki Ay düğümünü, 6 asteroidi, 9 Uranyen/kurgusal gök cismini ve 9 gezegen uydusunu kapsayan 36 kabul edilen değer. Tanınmayan bir ad hata vermez, sessizce None değerine eşlenir ve ardından efemeris motorunun derinlerinde hataya yol açar. Düğümler için alt çizgili MEAN_NODE / TRUE_NODE biçimleri kullanılır ('RAHU'/'KETU' takma adı yoktur).
celestial2	string	isteğe bağlı	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 10 gezegeni, iki Ay düğümünü, 6 asteroidi, 9 Uranyen/kurgusal gök cismini ve 9 gezegen uydusunu kapsayan 36 kabul edilen değer. Tanınmayan bir ad hata vermez, sessizce None değerine eşlenir ve ardından efemeris motorunun derinlerinde hataya yol açar. Düğümler için alt çizgili MEAN_NODE / TRUE_NODE biçimleri kullanılır ('RAHU'/'KETU' takma adı yoktur).
degr	number (double)	isteğe bağlı
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
nakshatras	string	isteğe bağlı	`special` HTTP katmanında ÖLÜ PARAMETRE: TransitView bu alanı hiç iletmez, bu yüzden göndermenin hiçbir etkisi yoktur. Motorda anlamlı tek değer, varsayılan 27 girişli tablo yerine 28 girişli nakshatras_special tablosunu seçen 'special' değeridir.
when	string	isteğe bağlı	`afterbefore` Motordaki varsayılan değer 'after'. 'solar_crossing', 'find_moon_crossing', 'moon_node_crossing' ve 'celestial_conjunction' anahtarları kullanır.
x2cross	number (double)	isteğe bağlı

Kullanılabilir anahtarlar (8)

İstediğiniz hesaplamaları keys içinde tek tek sayın; yalnızca onlar hesaplanır. Bilinmeyen tek bir anahtar bile isteğin tamamını reddettirir. Kaç anahtar isterseniz isteyin ücret 1 kredi olur; bu yüzden hepsini tek istekte toplayın.

Anahtar	Gereken ek alanlar	Açıklama
celestial_conjunction	celestial1, celestial2, datetime_start, when	`datetime_start` sonrasında `celestial1` ve `celestial2` gök cisimlerinin aynı ekliptik boylamda bulunduğu ilk an. Bir nesne döndürür: `long1` ve `long2` bulunan andaki iki boylamdır (arama belirli bir toleransa kadar yakınsadığı için birbirine yakındır ama tam eşit değildir); `date` ise ISO zaman damgasıdır.
find_moon_crossing	x2cross, date_time, tz, when	Ay'ın `x2cross` içinde verilen ekliptik boylama ulaştığı an; arama `when` değerine göre `date_time` anından ileriye veya geriye doğru yapılır. `tz` kadar kaydırılmış tek bir ISO zaman damgası döndürür. Ay günde yaklaşık 13 derece ilerlediği için sonuç normalde referans zamandan en fazla bir ay uzaktadır.
moon_node_crossing	date_time, tz, when	Ay düğümünün bir sonraki veya önceki geçişi; arama `date_time` anından `when` ile belirtilen yönde yapılır. Bir nesne döndürür: `date`, `tz` kadar kaydırılmış ISO zaman damgasıdır; `long` ve `lat` ise o andaki ekliptik boylam ve enlemdir. Tutulma mevsimlerini bulmak için kullanışlıdır.
planet_transit	degr, planet, datetime_start, datetime_end, tz	`planet` içinde adı verilen gök cisminin `degr` içinde verilen ekliptik boylamı geçtiği an; `datetime_start` ile `datetime_end` arasında aranır. `tz` kadar kaydırılmış tek bir ISO zaman damgası döndürür; gök cismi bu aralıkta o dereceye hiç ulaşmazsa null döner. Güneş ve Ay geçişlerinin aksine bu arama sınırlıdır; bu yüzden olayı kapsayacak kadar geniş bir aralık verin.
set_default_transit	—	Hesaplama değil, mod değiştiricidir: isteğin geri kalanı için efemerisi tropikale ayarlar (ayanamsa uygulanmaz). null döndürür. Anahtarlar listelediğiniz sırayla işlenir; bu yüzden bunu, etkilemesi gereken geçiş anahtarlarından önce yazın.
set_sidereal_transit	—	Hesaplama değil, mod değiştiricidir: efemerisi sideral olarak ayarlar; böylece aynı istekteki sonraki geçişler ve konumlar tropikal sıfır noktasına göre değil, ayanamsaya göre ölçülür. null döndürür ve etkilemesi gereken anahtarlardan önce listelenmelidir.
solar_crossing	x2cross, date_time, tz, when	Güneş'in `x2cross` içinde verilen ekliptik boylama ulaştığı an; arama `when` değerine göre `date_time` anından ileriye veya geriye doğru yapılır. `tz` saat farkı kadar kaydırılmış tek bir ISO zaman damgası döndürür. Sideral yeni yılı bulmak için 0, doğum gününü dakikasına kadar bulmak için natal Güneş boylamını gönderin.
transit_details	celestial, date_time, tz	`celestial` içinde adı verilen gök cisminin `date_time` anındaki konumunun ayrıntılı dökümü. Döndürülen nesnede şunlar bulunur: önceden biçimlendirilmiş gösterim string'i olarak `longitude`; `nakshatra` ve onun yöneticisi `nakshatra_lord`; `padam` (nakshatranın çeyreği, 1-4); `full_degree` (sideral boylamın 30'a bölümü, yani burç numarası ve burç içinde ilerlenen kesir); `{degrees, minutes, seconds}` biçiminde `latitude_shara`; string olarak, gün başına derece cinsinden `speed`; 'hh.mm.ss.ss' biçiminde `right_ascension` ve string olarak, derece cinsinden `declination_kranti`.

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/transit/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-20T06:52:42.466Z","keys":["set_sidereal_transit","planet_transit","solar_crossing","celestial_conjunction","transit_details"],"latitude":26.1046,"longitude":75.7873,"tz":5.5,"planet":"MARS","datetime_start":"2024-11-20T06:52:42.466Z","datetime_end":"2040-11-20T06:52:42.466Z","degr":0,"x2cross":0,"celestial1":"SATURN","celestial2":"SUN","celestial":"MARS","when":"after"}'

Yanıt

{
  "data": {
    "set_sidereal_transit": null,
    "planet_transit": "2026-05-11T12:38:41+05:30",
    "solar_crossing": "2025-04-14T03:21:25+05:30",
    "celestial_conjunction": {
      "long1": 327.886,
      "long2": 327.877,
      "date": "2025-03-12T10:13:52.466000Z"
    },
    "transit_details": {
      "longitude": "4° Mesh 4'° 25\"",
      "nakshatra": "Makha",
      "padam": 2,
      "nakshatra_lord": "Ketu",
      "full_degree": 4.15,
      "latitude_shara": {
        "degrees": 2,
        "minutes": 5,
        "seconds": 52.8
      },
      "speed": "0.2",
      "right_ascension": "08.29.10.92",
      "declination_kranti": "21.19"
    }
  },
  "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, istediğiniz her anahtarın adıyla 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.