POST/api/astro/lunar/void-of-course/1 क्रेडिट

शून्य-मार्ग चंद्रमा (void of course)

राशि बदलने से पहले चंद्रमा कोई और दृष्टि बनाएगा या नहीं। जब चंद्रमा किसी राशि में अपनी आख़िरी दृष्टि पूरी कर चुका हो और पूरी करने को कोई दृष्टि न बची हो, तब वह शून्य-मार्ग (void of course) कहलाता है। मुहूर्त (electional) ज्योतिष में शून्य-मार्ग चंद्रमा को कोई भी काम शुरू करने के लिए खराब समय माना जाता है, इसीलिए चंद्रमा के बारे में लोग असल में यही सवाल खोजते हैं। इसका उत्तर किसी एक क्षण की तस्वीर से नहीं, आगे की ओर खोज से मिलता है: चंद्रमा दिन में लगभग तेरह अंश चलता है और दूसरे ग्रह भी चलते रहते हैं, इसलिए दो अंश दूर की दृष्टि पूरी भी हो सकती है और छूट भी सकती है — यह इस पर निर्भर है कि धीमा पिंड उससे दूर भाग रहा है या नहीं। यह एंडपॉइंट राशि से निकलने तक स्कैन करता है और पूरी होने वाली हर दृष्टि का क्षण द्विभाजन (bisection) से निकालता है, दोनों दिशाओं में — चंद्रमा किसी ग्रह की ओर आगे से भी बढ़ सकता है और पीछे से भी, और दोनों ही दृष्टियाँ हैं। उत्तर में मिलता है: चंद्रमा अभी शून्य-मार्ग है या नहीं, बची हुई हर दृष्टि और उसके पूरी होने का सटीक क्षण, चंद्रमा राशि से कब निकलेगा, और शून्य-मार्ग अवधि कब शुरू होकर कब ख़त्म होगी। `include_modern` तय करता है कि यूरेनस, नेपच्यून और प्लूटो गिने जाएँ या नहीं। यह डिफ़ॉल्ट रूप से बंद है, क्योंकि कोई भी पारंपरिक स्रोत इन्हें नहीं गिनता और इन्हें शामिल करने से शून्य-मार्ग अवधियाँ बहुत कम हो जाती हैं। कौन-सी परिपाटी इस्तेमाल हुई, यह उत्तर में बताया जाता है।

https://api.occultapi.com/api/astro/lunar/void-of-course/

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

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
include_modern	boolean	वैकल्पिक	यूरेनस, नेपच्यून और प्लूटो से बनने वाली दृष्टियाँ भी गिनें। पारंपरिक पद्धति में केवल सात शास्त्रीय पिंड गिने जाते हैं, और तीन और जोड़ने से शून्य-मार्ग अवधियाँ काफ़ी कम हो जाती हैं।
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
orb_factor	number (double)	वैकल्पिक	सभी दृष्टियों के ऑर्ब एक साथ घटाएँ-बढ़ाएँ। 0.5 देने पर ऑर्ब आधे हो जाते हैं, 2 देने पर दोगुने। min 0.1 · max 2
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/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}'

उत्तर

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

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

त्रुटियाँ

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