POST/api/astro/fixed-star/parans/1 क्रेडिट

तारों और ग्रहों के पैरान

वे अक्षांश, जहाँ कोई स्थिर तारा और कोई ग्रह एक ही क्षण में कोणों पर होते हैं। Bernadette Brady की परंपरा स्थिर तारों को पैरान से ही देखती है, और पैरान ऐसा संपर्क पकड़ लेते हैं जो भोगांश वाली युति में बिल्कुल छूट जाता है: कोई तारा राशिचक्र में ग्रह के आसपास भी न हो, फिर भी ठीक उसी क्षण उदय हो सकता है जब वह ग्रह शिरोबिंदु पर हो। जवाब एक अक्षांश (LATITUDE) है, इसलिए यह किसी एक जगह पर नहीं, उस अक्षांश पर पूरी पृथ्वी पर लागू होता है। हल /api/astro/astrocartography/parans/ वाली ज्यामिति से ही निकाला जाता है, बस एक पिंड की जगह तारा होता है। याम्योत्तर रेखाओं की जोड़ियाँ छोड़ दी जाती हैं: MC और IC रेखाएँ असली याम्योत्तर हैं और कभी नहीं कटतीं।

https://api.occultapi.com/api/astro/fixed-star/parans/

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

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
bodies	array	वैकल्पिक
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
max_magnitude	number (double)	वैकल्पिक	केवल इतने या इससे ज़्यादा चमकीले तारे रखें। संख्या जितनी छोटी, तारा उतना चमकीला।
preset	string	वैकल्पिक	major (डिफ़ॉल्ट), behenian, brightest, या all। `majorbehenianbrightestall`
stars	array	वैकल्पिक	तारों के नाम। ये दिए हों, तो `preset` की जगह यही माने जाते हैं।
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/fixed-star/parans/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"stars":["Regulus","Sirius","Aldebaran"],"bodies":["sun","moon","mars"]}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"julian_day_ut\": 2448022.10069444, \"stars_considered\": 3, \"count\": 30, \"parans\": [{\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 64.923938}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"MC\", \"latitude_deg\": 62.975951}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 62.127117}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"IC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": 61.589729}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": 56.671965}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": 55.724692}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"mars\", \"body_line\": \"IC\", \"latitude_deg\": 54.239126}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 53.107724}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"MC\", \"latitude_deg\": 50.110307}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 46.105875}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"MC\", \"body\": \"mars\", \"body_line\": \"DC\", \"latitude_deg\": 45.266728}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"MC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": 38.661486}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"IC\", \"latitude_deg\": 30.223657}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"DC\", \"body\": \"mars\", \"body_line\": \"IC\", \"latitude_deg\": 24.393792}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"MC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": 15.27243}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"IC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -15.27243}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"AC\", \"body\": \"mars\", \"body_line\": \"MC\", \"latitude_deg\": -24.393792}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"moon\", \"body_line\": \"MC\", \"latitude_deg\": -30.223657}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"IC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": -38.661486}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"IC\", \"body\": \"mars\", \"body_line\": \"AC\", \"latitude_deg\": -45.266728}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -46.105875}, {\"star\": \"Regulus\", \"designation\": \"alLeo\", \"magnitude\": 1.4, \"star_line\": \"DC\", \"body\": \"sun\", \"body_line\": \"IC\", \"latitude_deg\": -50.110307}, {\"star\": \"Aldebaran\", \"designation\": \"alTau\", \"magnitude\": 0.86, \"star_line\": \"AC\", \"body\": \"moon\", \"body_line\": \"DC\", \"latitude_deg\": -53.107724}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"mars\", \"body_line\": \"MC\", \"latitude_deg\": -54.239126}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"AC\", \"body\": \"sun\", \"body_line\": \"AC\", \"latitude_deg\": -55.724692}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"MC\", \"body\": \"moon\", \"body_line\": \"AC\", \"latitude_deg\": -56.671965}, {\"star\": \"Sirius\", \"designation\": \"alCMa\", \"magnitude\": -1.46, \"star_line\": \"MC\", \"body\": \"sun\", \"body_line\": \"DC\", \"latitude_deg\": "
}

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

त्रुटियाँ

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