POST/api/astro/mundane/conjunctions/1 क्रेडिट

ग्रह युतियाँ

दो पिंड अगली बार कब एक ही भोगांश पर होंगे। ग्रह युति आकाश की घटना है, इसमें कोई जन्म कुंडली नहीं होती। इसीलिए यह एंडपॉइंट गोचर वाले एंडपॉइंट के साथ नहीं, बल्कि /api/astro/mundane/ingresses/ और /api/astro/mundane/stations/ के साथ रखा गया है। जोड़ी `celestial1` और `celestial2` से चुनें। तारीख़ के साथ, युति के क्षण पर दोनों भोगांश भी मिलते हैं — खोज तब रुकती है जब दोनों मिलते हैं, इसलिए दोनों वैल्यू का बराबर होना ही इस बात की जाँच है कि युति सचमुच हुई।

https://api.occultapi.com/api/astro/mundane/conjunctions/

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

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
celestial	string	वैकल्पिक	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial1	string	वैकल्पिक	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
celestial2	string	वैकल्पिक	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
datetime_end	string (date-time)	वैकल्पिक
datetime_start	string (date-time)	वैकल्पिक
degr	number (double)	वैकल्पिक	min 0 · max 360
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
planet	string	वैकल्पिक	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node`
timezone_as_float	number (double)	वैकल्पिक	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14
tz	number (double)	वैकल्पिक	लौटाए गए समय इसी UTC ऑफ़सेट में होते हैं। min -12 · max 14
when	string	वैकल्पिक	केवल आगे की ओर; `before` के बारे में मॉड्यूल का docstring देखें। `after`
x2cross	number (double)	वैकल्पिक	जिस भोगांश को पार करना है, 0 मेष से 0-360 के बीच। min 0 · max 360

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/mundane/conjunctions/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2025-01-01T00:00:00+00:00","tz":0,"when":"after","celestial1":"jupiter","celestial2":"saturn"}'

उत्तर

{
  "data": {
    "bodies": [
      "jupiter",
      "saturn"
    ],
    "conjunction": "2040-10-31T09:02:40Z",
    "longitude_1": 173.483,
    "longitude_2": 173.493
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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