POST/api/astro/moon-illumination/1 क्रेडिट

चंद्रमा का प्रकाशित भाग और कला

चंद्रमा का कितना हिस्सा प्रकाशित है, असली भिन्न के रूप में। गणना सूर्य और चंद्रमा की कोणीय दूरी से होती है: lit = (1 - cos(elongation)) / 2, जो अमावस्या पर 0, दोनों चतुर्थांशों पर 0.5 और पूर्णिमा पर 1 होता है। यह भिन्न और प्रतिशत, दोनों रूपों में मिलता है, साथ में कोणीय दूरी, कला कोण (phase angle), चंद्रमा बढ़ रहा है या नहीं, और कला का पारंपरिक नाम। यह एंडपॉइंट इसलिए बनाया गया, क्योंकि `get_illumination` नाम की इंजन key प्रकाशित भाग नहीं लौटाती। वह दृश्य मैग्निट्यूड (apparent magnitude) लौटाती है — सूर्य के लिए लगभग -26.7 और चंद्रमा के लिए कला के अनुसार -6 से -12 के बीच। भिन्न ऋणात्मक नहीं हो सकती, -26 तो बिल्कुल नहीं; जो भी इस फ़ील्ड को "प्रतिशत प्रकाशित" डिस्प्ले से जोड़ेगा, वह बेतुके आँकड़े दिखाएगा। वह वैल्यू यहाँ भी मिलती है, पर अपने सही नाम से: apparent_magnitude, जिसमें कम मान का मतलब ज़्यादा चमक है।

https://api.occultapi.com/api/astro/moon-illumination/

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

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
altitude	number (double)	वैकल्पिक	प्रेक्षक की ऊँचाई (समुद्र तल से), मीटर में; यह किसी पिंड की ऊँचाई नहीं है।
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
planet_names	array	वैकल्पिक	अनदेखा किया जाता है। यह एंडपॉइंट हमेशा सूर्य और चंद्रमा को ही पढ़ता है।
time_zone	number (double)	वैकल्पिक	UTC ऑफ़सेट। यह या timezone_as_float, दोनों में से कोई एक दें; दोनों का काम एक ही है। min -12 · max 14
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/moon-illumination/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-09T12:00:00+00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":0}'

उत्तर

{
  "data": {
    "illuminated_fraction": 0.034082,
    "illuminated_percent": 3.4082,
    "elongation_degrees": 21.277,
    "phase_angle_degrees": 338.723,
    "waxing": false,
    "phase_name": "New moon",
    "apparent_magnitude": {
      "moon": -6.123776,
      "sun": -26.726421
    },
    "longitudes": {
      "sun": 166.834,
      "moon": 145.557
    },
    "notes": {
      "apparent_magnitude": "The engine key named get_illumination returns apparent magnitude, not illumination. Smaller is brighter; it is negative for both of these bodies. Use illuminated_fraction for how much of the disc is lit."
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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