POST/api/astro/eclipse/attributes/1 क्रेडिट

किसी क्षण पर ग्रहण की स्थिति

किसी एक क्षण, किसी एक जगह से देखने पर ग्रहण कितना गहरा है। यह खोज नहीं, एक झलक है: इस सेकंड, इन निर्देशांकों से, बिंब का कितना हिस्सा ढका है, पिंड क्षितिज से कितना ऊपर है, मैग्निट्यूड कितना है, और ग्रहण किस सारोस श्रृंखला का है। ग्रहण के दौरान आच्छादन हर मिनट बदलता है, इसलिए पूरे ग्रहण के दौरान इस एंडपॉइंट को थोड़े-थोड़े अंतराल पर कॉल करें, तो आच्छादन का पूरा वक्र मिल जाता है — लाइव ट्रैकर को यही चाहिए, और स्पर्श समयों की सूची यह नहीं दे सकती। यह /api/astro/eclipse/local/ से अलग है, जो किसी जगह से दिखने वाला अगला ग्रहण खोजता है और उसके स्पर्श समय लौटाता है। यह उस क्षण को मापता है जो आपके पास पहले से है: चरम पर गहराई जाननी हो, तो इसे /local/ या /upcoming/ से मिला maximum दें। प्रच्छाया और उपच्छाया मैग्निट्यूड चाहिए, तो kind को "lunar" करें। चंद्र ग्रहण में आच्छादन नहीं होता — यह सूर्य ग्रहण की धारणा है — इसलिए यह फ़ील्ड शून्य नहीं आता, आता ही नहीं। अगर उस क्षण उस जगह कोई ग्रहण नहीं लग रहा, तो उत्तर साफ़ यही बताता है; शून्यों से भरा ऐसा पेज नहीं लौटाता, जो असली माप जैसा लगे।

https://api.occultapi.com/api/astro/eclipse/attributes/

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

ऑथेंटिकेशन

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

उत्तर

{
  "data": {
    "kind": "solar",
    "in_progress": true,
    "type": "partial",
    "moment": "2026-08-12T17:46:00Z",
    "place": {
      "latitude": 64.1466,
      "longitude": -21.9426,
      "elevation": 0
    },
    "attributes": {
      "solar_diameter_fraction_covered": 0.9694113526477836,
      "lunar_to_solar_diameter_ratio": 1.0392513179040108,
      "obscuration": 0.9698071068665648,
      "core_shadow_diameter_km": -132.45757926321468,
      "sun_azimuth": 72.06950998795764,
      "sun_true_altitude": 24.78900312370976,
      "sun_apparent_altitude": 24.824074556487865,
      "moon_elongation": 0.026420359347729915,
      "magnitude_nasa": 0.9694113526477836,
      "saros_series": 126,
      "saros_member": 48
    },
    "saros": {
      "series": 126,
      "member": 48
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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