प्लेग्राउंड लोड हो रहा है
curl -X POST https://api.occultapi.com/api/astro/star/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"name":"Aldebaran","keys":["set_default_positions","magnitude"]}'किसी नाम वाले स्थिर तारे का स्थिति डेटा, मानक स्थिर-तारा सूची से। वैदिक और पाश्चात्य, दोनों ज्योतिष कुछ चमकीले तारों को संकेत-बिंदु की तरह इस्तेमाल करते हैं — Aldebaran, Regulus, Spica, Antares — और नक्षत्रों के नाम भी उनके योगताराओं पर हैं, यानी वे मुख्य तारे जिनसे नक्षत्र पहचाने जाते हैं। यह एंडपॉइंट किसी तारे के क्रांतिवृत्तीय और विषुवतीय निर्देशांक, उनके बदलने की दर, और तारे की चमक देता है। `name` में पारंपरिक नाम (`Aldebaran`, `Regulus`) या Bayer पदनाम (`alTau`, `alLeo`) भेजें; मिलान में केस और स्पेस का ध्यान नहीं रखा जाता, और शुरू में कॉमा लगाने पर नाम को Bayer पदनाम ही माना जाता है। साथ में `date_time`, `timezone_as_float` और जो `keys` चाहिए, वे भेजें। महत्वपूर्ण: `keys` में सबसे पहले `set_default_positions` रखें। Keys उसी क्रम में चलती हैं जिसमें आप उन्हें भेजते हैं, और स्थिति वाली हर key उन गणना फ़्लैग पर निर्भर है जो यह कॉल सेट करती है — इसके बिना वे विफल हो जाती हैं। केवल `magnitude`, जो सीधे सूची से आती है, इसके बिना काम करती है। स्थितियाँ निरयन हैं। `latitude` और `longitude` स्वीकार तो होते हैं, पर इस्तेमाल नहीं होते; स्थिर तारे की भूकेंद्रीय स्थिति इस पर निर्भर नहीं करती कि आप कहाँ खड़े हैं।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| name | string | ज़रूरी | AldebaranRohiniAlgolAntaresRegulusSiriusSpicaTrappist-1Galactic CenterGal. CenterGreat AttractorVirgo Clusterमानक स्थिर-तारा सूची का कोई स्थिर तारा: पारंपरिक नाम (Aldebaran, Regulus, Spica) या Bayer पदनाम (alTau, alLeo)। मिलान में केस और स्पेस का ध्यान नहीं रखा जाता। नाम को Bayer पदनाम ही मनवाना हो तो आगे कॉमा लगाएँ, जैसे ',alTau'। लगभग 735 पारंपरिक नाम और 1117 पदनाम उपलब्ध हैं, जिनमें Galactic Center जैसे बिंदु भी हैं जो तारे नहीं हैं। अनजान नाम पर 400 मिलता है। |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| latitude | number (double) | वैकल्पिक | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9 |
| longitude | number (double) | वैकल्पिक | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| declination | date_time | `date_time` पर तारे की क्रांति, यानी खगोलीय विषुवत से उत्तर या दक्षिण में उसका कोण, `{degrees, minutes, seconds}` के रूप में। बदलते समय निरपेक्ष मान लिया जाता है, इसलिए चिह्न हट जाता है और दक्षिणी क्रांति उत्तरी जैसी ही दिखती है — गोलार्ध चाहिए तो तारे की सूची वाली स्थिति से लें। | |
| distance | date_time | `date_time` पर पृथ्वी से तारे की दूरी: खगोलीय इकाइयों में एक संख्या, तीन दशमलव स्थानों तक पूर्णांकित। | |
| ecliptic_speeds | date_time | `date_time` पर तारे के क्रांतिवृत्तीय निर्देशांक कितनी तेज़ी से बदल रहे हैं, `{longitude_speed, latitude_speed, distance_speed}` के रूप में — पहले दो अंश प्रति दिन में, आख़िरी खगोलीय इकाई प्रति दिन में। मान बहुत छोटे होते हैं, क्योंकि स्थिर तारे की दिखने वाली गति कक्षा में घूमने से नहीं, अयन-चलन और उसकी निजी गति से आती है। | |
| equatorial_speeds | date_time | `date_time` पर तारे के विषुवतीय निर्देशांक कितनी तेज़ी से बदल रहे हैं, `{right_ascension_speed, declination_speed, distance_speed}` के रूप में — पहले दो अंश प्रति दिन में, आख़िरी खगोलीय इकाई प्रति दिन में। | |
| latitude | date_time | `date_time` पर तारे का शर (क्रांतिवृत्तीय अक्षांश) — यानी वह क्रांतिवृत्त के तल से कितना उत्तर या दक्षिण में है — अंशों में एक संख्या, तीन दशमलव स्थानों तक पूर्णांकित, दक्षिण में ऋणात्मक। इसी वजह से कोई तारा राशिचक्र की पट्टी से बाहर होता है, और इसीलिए कुछ चमकीले तारे किसी ग्रह से कभी सटीक युति नहीं करते। | |
| longitude | date_time | `date_time` पर तारे का निरयन भोगांश: अंशों में 0 से 360 तक की एक संख्या, तीन दशमलव स्थानों तक पूर्णांकित। | |
| magnitude | — | सूची में दर्ज तारे का दृश्य मैग्निट्यूड, एक संख्या; मान जितना कम, तारा उतना चमकीला, इसलिए Aldebaran के लिए 0.86 मिलता है। इस एंडपॉइंट की यही अकेली key है जिसे न तारीख़ चाहिए, न पहले से `set_default_positions` की कॉल। | |
| retrograde | date_time | क्या `date_time` पर तारे का भोगांश घट रहा है: एक बूलियन, जो `longitude_speed` ऋणात्मक होने पर true होता है। स्थिर तारे के लिए यह व्यवहार में हमेशा false रहता है, क्योंकि अयन-चलन उसे निरयन राशिचक्र में आगे की ओर ले जाता है। | |
| right_ascension | date_time | `date_time` पर तारे का विषुवांश, यानी खगोलीय विषुवत पर उसका पूर्व-पश्चिम निर्देशांक; दशमलव अंशों में नहीं, `{hours, minutes, seconds}` के रूप में। | |
| set_default_positions | — | यह स्विच है, वैल्यू नहीं: गति सहित दृश्य भूकेंद्रीय स्थितियाँ सेट करती है, और /api/astro/celestial/ पर इसी नाम की key से अलग, यह SIDEREAL (निरयन) फ़्लैग भी सेट करती है - इसलिए इस एंडपॉइंट का डिफ़ॉल्ट सायन नहीं, निरयन है। null लौटाती है। इसे `keys` में सबसे पहले रखें: स्विच केवल अपने बाद लिखी keys पर लागू होते हैं। |