curl -X POST https://api.occultapi.com/api/astro/return/saturn/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"search_from":"2015-01-01T00:00:00+00:00","count":2}'Satürn'ün natal derecesine geri döndüğü an; yaklaşık 29, 58 ve 88 yaşlarında gerçekleşir. Tek bir tarih yerine kesin GEÇİŞLERİN listesi olarak döner, çünkü Satürn kendi natal derecesinden genellikle üç kez geçer: önce direkt, sonra retro hareketle geriye doğru, ardından yeniden direkt. Bu üç an arasında dokuz ay olabilir ve bu dönüş çoğunlukla yalnızca ilk geçiş verilerek yanlış bildirilir. Bir dönüş ya tek geçişten ya da üç geçişten oluşur, hiçbir zaman iki geçişten oluşmaz.
| 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. |
| ayanamsa | string | isteğe bağlı | TROPICAL (varsayılan) veya LAHIRI, KRISHNAMURTI, RAMAN ya da FAGAN_BRADLEY gibi bir ayanamsa adı; büyük/küçük harfe duyarsızdır. Sideral bir ayanamsa seçildiğinde, ayanamsanın o andaki değeri döndürülen her boylamdan çıkarılır. |
| count | integer | isteğe bağlı | Döndürülecek ardışık dönüş sayısı, en fazla 24. min 1 · max 24 |
| exact_passes | boolean | isteğe bağlı | Duraklamaları hesaba katan aramayı kullanır: bir duraklamanın iki yanında birkaç saat arayla gerçekleşen geçişler dahil tüm geçişleri bulur ve geçişleri yer merkezli retro döngüsüne göre gruplar (Merkür ve Venüs dahil). Yanıta "exact_passes": true ekler. Varsayılan false değeriyle mevcut arama değişmeden çalışır. |
| include_asteroid_lilith | boolean | isteğe bağlı | (1181) Lilith asteroidini, diğer gök cisimlerinden sonra "asteroid_lilith" adıyla ekler. Bu cisim Kara Ay Lilith'ten farklıdır. |
| include_lilith | boolean | isteğe bağlı | Kara Ay Lilith'i (ortalama Ay yerötesi), diğer gök cisimlerinden sonra "lilith" adıyla ekler. |
| 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. |
| 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. |
| search_from | string (date-time) | isteğe bağlı | Arama doğum anı yerine bu andan başlar. |
| 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 |