POST/api/astro/eclipse/next-lunar/1 क्रेडिट

अगला चंद्र ग्रहण

अगला चंद्र ग्रहण, उपच्छाया, आंशिक और पूर्ण चरणों के नामों के साथ। कच्चा ऐरे पढ़ने से बेहतर है इसे इस्तेमाल करना: चंद्र ग्रहण के समय वाला कच्चा ऐरे उस क्रम में नहीं है, जिसका कोई अंदाज़ा लगाएगा। आइटम 1 इस्तेमाल नहीं होता, आइटम 2 और 3 आंशिक चरण हैं, और 6 और 7 उपच्छाया चरण, इसलिए बाएँ से दाएँ सीधे पढ़ें, तो पूरी टाइमलाइन पर गलत लेबल लग जाते हैं। इन फ़ील्ड के नाम इंजन के जाँचे हुए इंडेक्स मैप से रखे गए हैं।

https://api.occultapi.com/api/astro/eclipse/next-lunar/

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

अगला चंद्र ग्रहण का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
direction	string	वैकल्पिक	date_time से आगे की ओर खोजें या पीछे की ओर। `afterbefore`
elevation	number (double)	वैकल्पिक
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
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/eclipse/next-lunar/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-01-01T00:00:00+00:00","timezone_as_float":0,"direction":"after"}'

उत्तर

{
  "data": {
    "found": true,
    "searched_from": "2026-01-01T00:00:00Z",
    "direction": "after",
    "eclipse": {
      "kind": "lunar",
      "type": "total",
      "centrality": null,
      "maximum": "2026-03-03T11:33:42Z",
      "times": {
        "maximum": "2026-03-03T11:33:42Z",
        "partial_begin": "2026-03-03T09:50:06Z",
        "partial_end": "2026-03-03T13:17:18Z",
        "totality_begin": "2026-03-03T11:04:34Z",
        "totality_end": "2026-03-03T12:02:51Z",
        "penumbral_begin": "2026-03-03T08:44:25Z",
        "penumbral_end": "2026-03-03T14:23:08Z"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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