POST/api/astro/dasha/drill/1 kredi

Dasha ayrıntısı

Dasha ağacının tamamı yerine yalnızca tek bir dalı. Diğer dasha endpoint'lerindeki levels DERİNLİĞİ sınırlar, ama o derinlikteki dönemlerin hepsini yine de döndürür: Vimshottari'de levels=3, her mahadashanın içindeki her antardashanın içindeki tüm pratyantardashalar demektir ve yaklaşık 95 KB tutar. Kullanıcının tek bir mahadashaya dokunup açtığı bir ekranın ise bunun yalnızca bir dalına ihtiyacı vardır. Bu endpoint'e izlenecek yönetici zincirini verin; yalnızca belirttiğiniz dönemin altındakileri döndürür. {"lords": ["moon", "mars"], "levels": 1}, Ay mahadashasının Mars antardashası içindeki pratyantardashaları döndürür — bunu içeren ağacın 95 KB'ına karşılık yaklaşık 1.8 KB. Yönetici adları büyük/küçük harf ayrımı yapılmadan eşleştirilir; yanıttaki path, gerçekte eşleşen zinciri gösterir. Nakshatra dashaları için gezegen adı, Jaimini rashi dashaları için burç adı kullanın; tanınmayan bir yönetici, o düzeyde hangi seçeneklerin bulunduğunu listeleyen bir 400 döndürür. Bu endpoint HESAPLAMADAN değil, AKTARIMDAN tasarruf sağlar. Motor ağacı yine istediğiniz derinliğe kadar oluşturur, bu endpoint de geri kalanını atar; yani tek bir dalı almak, eşdeğer levels= çağrısından daha hızlı hesaplanmaz. Kazancınız bant genişliği, JSON ayrıştırma süresi ve bir tarayıcının ya da telefonun yalnızca tek dalını gösterdiği bir ağacı bellekte tutmak için harcayacağı alandır.

https://api.occultapi.com/api/astro/dasha/drill/

İ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
latitude	number (double)	zorunlu	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)	zorunlu	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
dasha_direction	string	isteğe bağlı	`forwardbackward`
dasha_start	string	isteğe bağlı	Zaman çizelgesinin hangi döngüden başlayacağı. `currentnextprevious`
date_time	string (date-time)	isteğe bağlı	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	string (date-time)	isteğe bağlı	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. date_time ile aynı anlama gelir; diğer endpoint'ler aynı alanı farklı bir adla kullanır.
days_in_year	number (double)	isteğe bağlı	Dönemlerin hesaplandığı yıl uzunluğu. Klasik savana yılı için 360, Jülyen yılı için 365.25. min 360 · max 365.256364
levels	integer	isteğe bağlı	Bulunan dönemin ALTINDA kaç düzey döndürüleceği. 1, yalnızca doğrudan alt dönemleri verir. min 1 · max 4
lords	array	isteğe bağlı	En üstten başlayarak izlenecek dönem yöneticileri zinciri, en dıştaki ilk sırada — ör. ["moon", "mars"], "Ay mahadashası içinde, onun Mars antardashası içinde" demektir. Nakshatra dashaları için gezegen adı, rashi dashaları için burç adı kullanın. Boş bırakılırsa en üst düzey döner.
node	string	isteğe bağlı	Ay düğümü modeli. Üst endpoint olan rashi endpoint'inde varsayılanı olmadığı için zorunludur; burada varsayılan değer atanır. `truemean`
system	string	isteğe bağlı	Dasha sistemi. Bkz. /api/astro/dasha/systems/. Varsayılan: Vimshottari.
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

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/dasha/drill/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"dasha_direction":"forward","dasha_start":"current","date_time":"2026-09-01 06:00:00","node":"true","timezone_as_float":5.5}'

Yanıt

{
  "data": {
    "system": "Vimshottari",
    "engine_id": "VimshottariDasha",
    "family": "nakshatra",
    "lord_type": "planet",
    "levels": 1,
    "level_names": [
      "mahadasha"
    ],
    "cycle_years": 120,
    "conditional": false,
    "path": [],
    "depth": 0,
    "child_level": "mahadasha",
    "periods": [
      {
        "lord": "ketu",
        "start": "2025-11-21 14:30:19.062048+00:00",
        "end": "2032-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "venus",
        "start": "2032-11-21 08:30:19.062048+00:00",
        "end": "2052-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "sun",
        "start": "2052-11-21 08:30:19.062048+00:00",
        "end": "2058-11-21 20:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "moon",
        "start": "2058-11-21 20:30:19.062048+00:00",
        "end": "2068-11-21 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mars",
        "start": "2068-11-21 08:30:19.062048+00:00",
        "end": "2075-11-22 02:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "rahu",
        "start": "2075-11-22 02:30:19.062048+00:00",
        "end": "2093-11-21 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "jupiter",
        "start": "2093-11-21 14:30:19.062048+00:00",
        "end": "2109-11-22 14:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "saturn",
        "start": "2109-11-22 14:30:19.062048+00:00",
        "end": "2128-11-22 08:30:19.062048+00:00",
        "children": []
      },
      {
        "lord": "mercury",
        "start": "2128-11-22 08:30:19.062048+00:00",
        "end": "2145-11-22 14:30:19.062048+00:00",
        "children": []
      }
    ],
    "metadata": {
      "calculation_time_ms": 0,
      "max_levels": 1,
      "data_size_bytes": 1171,
      "data_size_mb": 0,
      "structure": "nested_hierarchical"
    },
    "boundary_note": "The last sub-period of each period ends 18 hours before its parent does. Sibling periods are contiguous and the first child starts with its parent, but the final 18 hours of every period have no sub-period covering them. This comes from the calculation engine and is reported rather than hidden."
  },
  "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.