İçeriğe atla
POST/api/astro/lunar/void-of-course/1 kredi

Boşlukta Ay (void of course)

Ay'ın burç değiştirmeden önce başka bir açı yapıp yapmayacağı. Ay, bir burçtaki son açısını tamamladığında ve tamamlayacak başka açısı kalmadığında boşluğa girer. Seçim astrolojisi boşluktaki Ay'ı yeni bir işe başlamak için kötü bir zaman sayar; insanların gerçekten aradığı Ay sorusu da budur. Bunu yanıtlamak için anlık bir görüntü yetmez, ileriye doğru ARAMA gerekir: Ay günde yaklaşık on üç derece ilerler, diğer gezegenler de hareket eder; bu yüzden iki derece uzaktaki bir açı, yavaş olan gezegenin ondan uzaklaşıp uzaklaşmadığına göre tamamlanabilir de, kaçırılabilir de. Bu endpoint burçtan çıkışa kadar tarar ve tamamlanan her açıyı iki yönde de ikiye bölme yöntemiyle bulur — Ay bir gezegene önden de arkadan da yaklaşabilir ve ikisi de açıdır. Ay'ın şu anda boşlukta olup olmadığını, kalan her açıyı tamamlanacağı kesin anla birlikte, Ay'ın burçtan ne zaman çıkacağını ve boşluğun ne zaman başlayıp biteceğini döndürür. Uranüs, Neptün ve Plüton'un hesaba katılıp katılmayacağını `include_modern` belirler. Varsayılan olarak kapalıdır; çünkü hiçbir geleneksel kaynak bu gezegenleri kullanmaz ve onları dahil etmek boşluk dönemlerini çok daha seyrek hâle getirir. Kullanılan kural yanıtta adıyla belirtilir.

https://api.occultapi.com/api/astro/lunar/void-of-course/
İ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ı

AlanTürZorunluNotlar
date_timestring (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.

include_modernbooleanisteğe bağlı

Uranüs, Neptün ve Plüton'a yapılan açıları da hesaba katar. Geleneksel uygulama yalnızca yedi klasik gök cismini kullanır; üç cisim daha eklemek boşluk dönemlerini belirgin biçimde seyrekleştirir.

keysarrayisteğ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.

latitudenumber (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.

longitudenumber (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.

orb_factornumber (double)isteğe bağlı

Tüm açı orb'larını ölçekler. 0.5 orb'ları yarıya indirir, 2 iki katına çıkarır.

min 0.1 · max 2

timezone_as_floatnumber (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

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/lunar/void-of-course/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Yanıt

{
  "data": {
    "zodiac": "tropical",
    "as_of": "1990-08-15T05:00:00+00:00",
    "void_of_course": false,
    "moon": {
      "longitude": 72.660043,
      "speed": 14.262958,
      "sign": "Gemini",
      "sign_index": 3,
      "degree_in_sign": 12.66,
      "formatted": "12°39' Gemini"
    },
    "degrees_to_sign_change": 17.339957,
    "leaves_sign_at": "1990-08-16T10:12:11+00:00",
    "enters_sign": "Cancer",
    "next_aspect": {
      "planet": "mercury",
      "aspect": "square",
      "exact_angle": 90,
      "moon_is": "behind",
      "perfects_at": "1990-08-15T16:35:09+00:00",
      "julian_day": 2448119.1910816
    },
    "remaining_aspects": [
      {
        "planet": "mercury",
        "aspect": "square",
        "exact_angle": 90,
        "moon_is": "behind",
        "perfects_at": "1990-08-15T16:35:09+00:00",
        "julian_day": 2448119.1910816
      },
      {
        "planet": "sun",
        "aspect": "sextile",
        "exact_angle": 60,
        "moon_is": "behind",
        "perfects_at": "1990-08-15T22:04:59+00:00",
        "julian_day": 2448119.42013053
      }
    ],
    "void_begins_at": "1990-08-15T22:04:59+00:00",
    "void_ends_at": "1990-08-16T10:12:11+00:00",
    "bodies_considered": [
      "sun",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn"
    ],
    "convention": "traditional (classical seven only)",
    "note": "Void of course means no further Ptolemaic aspect perfects before the Moon changes sign. Judged here on seven bodies; the choice changes the answer."
  },
  "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.