POST/api/astro/dasha/drill/1 क्रेडिट

दशा की एक शाखा

पूरे दशा ट्री के बजाय उसकी बस एक शाखा। बाकी दशा एंडपॉइंट पर levels गहराई (DEPTH) तो सीमित करता है, पर उस गहराई तक की हर अवधि फिर भी लौटाता है: विंशोत्तरी पर levels=3 का मतलब है हर महादशा की हर अंतर्दशा की हर प्रत्यंतर्दशा, जो लगभग 95 KB बनता है। जिस स्क्रीन पर कोई एक महादशा पर टैप करके उसे खोलता है, उसे इसमें से बस एक शाखा चाहिए। इस एंडपॉइंट को स्वामियों की वह कड़ी दें जिस पर नीचे जाना है, और यह केवल आपकी बताई अवधि के नीचे का हिस्सा लौटाता है। {"lords": ["moon", "mars"], "levels": 1} चंद्र महादशा की मंगल अंतर्दशा के अंदर की प्रत्यंतर्दशाएँ लौटाता है — लगभग 1.8 KB, जबकि जिस ट्री में यह शाखा है, वह 95 KB का है। स्वामियों के नामों का मिलान केस-असंवेदी होता है, और उत्तर में path वह कड़ी दोहराता है जो असल में मेल खाई। नक्षत्र दशाओं के लिए ग्रह का नाम दें और जैमिनी की राशि दशाओं के लिए राशि का नाम; अनजान स्वामी पर 400 मिलता है, साथ में उस स्तर पर उपलब्ध नामों की सूची। इससे ट्रांसफ़र (TRANSFER) बचता है, गणना (COMPUTATION) नहीं। इंजन फिर भी आपकी माँगी गहराई तक पूरा ट्री बनाता है, और यह एंडपॉइंट बाकी हिस्सा छोड़ देता है; इसलिए इसकी गणना उतने ही levels= वाली कॉल से तेज़ नहीं होती। बचते हैं बैंडविड्थ, JSON पार्सिंग, और वह मेमोरी जो ब्राउज़र या फ़ोन को ऐसा पूरा ट्री रखने में लगती, जिसकी वह बस एक शाखा दिखा रहा है।

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

अनुरोध आज़माएँ

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
dasha_direction	string	वैकल्पिक	`forwardbackward`
dasha_start	string	वैकल्पिक	टाइमलाइन किस चक्र से शुरू हो। `currentnextprevious`
date_time	string (date-time)	वैकल्पिक	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
datetime	string (date-time)	वैकल्पिक	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है। इसका अर्थ date_time जैसा ही है; दूसरे एंडपॉइंट इसी चीज़ को दूसरे नाम से लेते हैं।
days_in_year	number (double)	वैकल्पिक	अवधियाँ किस लंबाई के वर्ष से मापी जाएँ। शास्त्रीय सावन वर्ष के लिए 360, जूलियन वर्ष के लिए 365.25। min 360 · max 365.256364
levels	integer	वैकल्पिक	मिली हुई अवधि के नीचे (BELOW) कितने स्तर लौटाने हैं। 1 देने पर उसकी सीधी उप-अवधियाँ मिलती हैं। min 1 · max 4
lords	array	वैकल्पिक	ऊपर से नीचे जाने के लिए अवधि-स्वामियों की कड़ी, सबसे बाहरी पहले — जैसे ["moon", "mars"] का मतलब है “चंद्र महादशा के अंदर, उसकी मंगल अंतर्दशा के अंदर”। नक्षत्र दशाओं के लिए ग्रह का नाम, राशि दशाओं के लिए राशि का नाम। खाली छोड़ें, तो सबसे ऊपर का स्तर मिलता है।
node	string	वैकल्पिक	चंद्र पात का मॉडल। राशि दशा वाला मूल एंडपॉइंट इसे ज़रूरी मानता है और इसका कोई डिफ़ॉल्ट नहीं रखता; यहाँ डिफ़ॉल्ट दिया गया है। `truemean`
system	string	वैकल्पिक	दशा पद्धति। /api/astro/dasha/systems/ देखें। डिफ़ॉल्ट विंशोत्तरी है।
timezone_as_float	number (double)	वैकल्पिक	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14

उदाहरण अनुरोध

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}'

उत्तर

{
  "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"
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।