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

गोचर पारगमन

यह एंडपॉइंट किसी तय समय की कुंडली नहीं बताता, बल्कि क्षण खोजता है। यह इस तरह के प्रश्नों के उत्तर देता है: सूर्य अगली बार मेष के 0 अंश पर कब पहुँचेगा, दो तारीख़ों के बीच मंगल किसी अंश को कब पार करेगा, शनि और सूर्य अगली बार एक ही भोगांश पर कब होंगे, और किसी क्षण पर कोई पिंड ठीक कहाँ है। दो keys गणना नहीं, मोड स्विच हैं। `set_default_transit` सादा सायन एफ़ेमेरिस चुनती है और `set_sidereal_transit` निरयन; दोनों null लौटाती हैं। अनुरोध में keys उसी क्रम में चलती हैं जिसमें आप उन्हें लिखते हैं, इसलिए आगे की खोजें निरयन चाहिए तो स्विच सबसे पहले रखें। `planet`, `celestial`, `celestial1` और `celestial2` फ़ील्ड बड़े अक्षरों वाले एफ़ेमेरिस नाम लेते हैं (`SUN`, `MOON`, `MEAN_NODE`, `TRUE_NODE`, `CHIRON`, यूरेनियन बिंदु और कई ग्रहों के चंद्रमा); यह यहाँ के ज़्यादातर दूसरे एंडपॉइंट में इस्तेमाल होने वाले `Sun`/`Moon` नामों से अलग शब्दावली है। `tz` घंटों में एक सादा ऑफ़सेट है, जो लौटने वाले हर टाइमस्टैम्प पर लगता है; `when` चुनता है कि संदर्भ समय के बाद ('after') खोजना है या पहले ('before'); और `datetime_start`/`datetime_end` `planet_transit` के लिए खोज की अवधि तय करते हैं।

https://api.occultapi.com/api/astro/transit/

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

गोचर पारगमन का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
datetime_end	string (date-time)	ज़रूरी
datetime_start	string (date-time)	ज़रूरी
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
planet	string	ज़रूरी	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 मान्य वैल्यू: 10 ग्रह, दोनों चंद्र पात, 6 क्षुद्रग्रह, 9 यूरेनियन/काल्पनिक पिंड और 9 ग्रहों के चंद्रमा। अनजान नाम पर त्रुटि नहीं आती, वह चुपचाप None बन जाता है, और फिर एफ़ेमेरिस इंजन के भीतर जाकर विफल होता है। ध्यान दें कि पातों के नाम अंडरस्कोर वाले हैं: MEAN_NODE / TRUE_NODE ('RAHU'/'KETU' जैसा कोई उपनाम नहीं है)।
tz	number (double)	ज़रूरी	min -12 · max 14
celestial	string	वैकल्पिक	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 मान्य वैल्यू: 10 ग्रह, दोनों चंद्र पात, 6 क्षुद्रग्रह, 9 यूरेनियन/काल्पनिक पिंड और 9 ग्रहों के चंद्रमा। अनजान नाम पर त्रुटि नहीं आती, वह चुपचाप None बन जाता है, और फिर एफ़ेमेरिस इंजन के भीतर जाकर विफल होता है। ध्यान दें कि पातों के नाम अंडरस्कोर वाले हैं: MEAN_NODE / TRUE_NODE ('RAHU'/'KETU' जैसा कोई उपनाम नहीं है)।
celestial1	string	वैकल्पिक	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 मान्य वैल्यू: 10 ग्रह, दोनों चंद्र पात, 6 क्षुद्रग्रह, 9 यूरेनियन/काल्पनिक पिंड और 9 ग्रहों के चंद्रमा। अनजान नाम पर त्रुटि नहीं आती, वह चुपचाप None बन जाता है, और फिर एफ़ेमेरिस इंजन के भीतर जाकर विफल होता है। ध्यान दें कि पातों के नाम अंडरस्कोर वाले हैं: MEAN_NODE / TRUE_NODE ('RAHU'/'KETU' जैसा कोई उपनाम नहीं है)।
celestial2	string	वैकल्पिक	`SUNMOONMERCURYVENUSMARSJUPITERSATURNURANUSNEPTUNEPLUTOMEAN_NODETRUE_NODE` 36 मान्य वैल्यू: 10 ग्रह, दोनों चंद्र पात, 6 क्षुद्रग्रह, 9 यूरेनियन/काल्पनिक पिंड और 9 ग्रहों के चंद्रमा। अनजान नाम पर त्रुटि नहीं आती, वह चुपचाप None बन जाता है, और फिर एफ़ेमेरिस इंजन के भीतर जाकर विफल होता है। ध्यान दें कि पातों के नाम अंडरस्कोर वाले हैं: MEAN_NODE / TRUE_NODE ('RAHU'/'KETU' जैसा कोई उपनाम नहीं है)।
degr	number (double)	वैकल्पिक
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -89.9 · max 89.9
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
nakshatras	string	वैकल्पिक	`special` HTTP लेयर पर निष्क्रिय पैरामीटर: TransitView इसे कभी आगे नहीं भेजता, इसलिए इसे भेजने से कुछ नहीं होता। इंजन में इसकी एक ही सार्थक वैल्यू है, 'special', जो डिफ़ॉल्ट 27 प्रविष्टियों वाली तालिका की जगह 28 प्रविष्टियों वाली nakshatras_special तालिका चुनती है।
when	string	वैकल्पिक	`afterbefore` इंजन का डिफ़ॉल्ट 'after' है। 'solar_crossing', 'find_moon_crossing', 'moon_node_crossing' और 'celestial_conjunction' keys में काम आता है।
x2cross	number (double)	वैकल्पिक

उपलब्ध keys (8)

आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।

Key	और कौन-से फ़ील्ड चाहिए	विवरण
celestial_conjunction	celestial1, celestial2, datetime_start, when	`datetime_start` के बाद का पहला क्षण जब `celestial1` और `celestial2` एक ही भोगांश पर हों। एक ऑब्जेक्ट लौटाती है: `long1` और `long2`, यानी उस क्षण दोनों के भोगांश — बहुत पास, पर ठीक बराबर नहीं, क्योंकि खोज एक तय सहनसीमा तक ही चलती है — और `date`, ISO टाइमस्टैम्प।
find_moon_crossing	x2cross, date_time, tz, when	वह क्षण जब चंद्रमा `x2cross` में दिए भोगांश पर पहुँचता है; खोज `date_time` से `when` के हिसाब से आगे या पीछे की ओर होती है। `tz` जितना खिसकाया गया एक ISO टाइमस्टैम्प लौटाती है। चंद्रमा रोज़ लगभग 13 अंश चलता है, इसलिए उत्तर आमतौर पर संदर्भ समय से एक महीने के भीतर होता है।
moon_node_crossing	date_time, tz, when	चंद्र पात को अगली या पिछली बार पार करने का क्षण; खोज `date_time` से `when` में दी गई दिशा में होती है। एक ऑब्जेक्ट लौटाती है: `date`, यानी `tz` जितना खिसकाया गया ISO टाइमस्टैम्प, और `long` व `lat`, यानी उस क्षण का भोगांश और शर। ग्रहण के मौसम पहचानने में काम आती है।
planet_transit	degr, planet, datetime_start, datetime_end, tz	वह क्षण जब `planet` में दिया गया पिंड `degr` में दिए भोगांश को पार करता है; खोज `datetime_start` और `datetime_end` के बीच होती है। `tz` जितना खिसकाया गया एक ISO टाइमस्टैम्प लौटाती है, या null, अगर पिंड इस अवधि में उस अंश तक पहुँचता ही नहीं। सूर्य और चंद्रमा वाली खोजों से अलग, यह खोज सीमित दायरे में होती है, इसलिए दायरा इतना चौड़ा रखें कि घटना उसमें आ जाए।
set_default_transit	—	यह मोड स्विच है, गणना नहीं: अनुरोध के बाकी हिस्से के लिए एफ़ेमेरिस को सायन (बिना अयनांश) पर सेट करती है। null लौटाती है। Keys उसी क्रम में चलती हैं जिसमें आप उन्हें लिखते हैं, इसलिए इसे उन पारगमन keys से पहले रखें जिन पर इसका असर चाहिए।
set_sidereal_transit	—	यह मोड स्विच है, गणना नहीं: एफ़ेमेरिस को निरयन पर सेट करती है, ताकि उसी अनुरोध में आगे के पारगमन और स्थितियाँ सायन शून्य बिंदु से नहीं, अयनांश के हिसाब से मापी जाएँ। null लौटाती है, और इसे उन keys से पहले लिखना ज़रूरी है जिन पर इसका असर चाहिए।
solar_crossing	x2cross, date_time, tz, when	वह क्षण जब सूर्य `x2cross` में दिए भोगांश पर पहुँचता है; खोज `date_time` से `when` के हिसाब से आगे या पीछे की ओर होती है। `tz` घंटे के ऑफ़सेट जितना खिसकाया गया एक ISO टाइमस्टैम्प लौटाती है। निरयन नववर्ष के लिए 0 भेजें, या मिनट तक सटीक जन्मदिन के लिए जन्म के समय का सौर भोगांश।
transit_details	celestial, date_time, tz	`date_time` पर `celestial` में दिए पिंड की पूरी स्थिति का ब्योरा। एक ऑब्जेक्ट लौटाती है: `longitude`, दिखाने के लिए पहले से फ़ॉर्मैट की गई स्ट्रिंग; `nakshatra` और उसका `nakshatra_lord`; `padam` (नक्षत्र का चौथाई भाग, 1-4); `full_degree` (निरयन भोगांश को 30 से भाग देकर, यानी राशि संख्या और उसमें तय किया गया हिस्सा); `{degrees, minutes, seconds}` के रूप में `latitude_shara`; अंश प्रति दिन में `speed`, स्ट्रिंग के रूप में; 'hh.mm.ss.ss' फ़ॉर्मैट में `right_ascension`; और अंशों में `declination_kranti`, स्ट्रिंग के रूप में।

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

curl -X POST https://api.occultapi.com/api/astro/transit/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-20T06:52:42.466Z","keys":["set_sidereal_transit","planet_transit","solar_crossing","celestial_conjunction","transit_details"],"latitude":26.1046,"longitude":75.7873,"tz":5.5,"planet":"MARS","datetime_start":"2024-11-20T06:52:42.466Z","datetime_end":"2040-11-20T06:52:42.466Z","degr":0,"x2cross":0,"celestial1":"SATURN","celestial2":"SUN","celestial":"MARS","when":"after"}'

उत्तर

{
  "data": {
    "set_sidereal_transit": null,
    "planet_transit": "2026-05-11T12:38:41+05:30",
    "solar_crossing": "2025-04-14T03:21:25+05:30",
    "celestial_conjunction": {
      "long1": 327.886,
      "long2": 327.877,
      "date": "2025-03-12T10:13:52.466000Z"
    },
    "transit_details": {
      "longitude": "4° Mesh 4'° 25\"",
      "nakshatra": "Makha",
      "padam": 2,
      "nakshatra_lord": "Ketu",
      "full_degree": 4.15,
      "latitude_shara": {
        "degrees": 2,
        "minutes": 5,
        "seconds": 52.8
      },
      "speed": "0.2",
      "right_ascension": "08.29.10.92",
      "declination_kranti": "21.19"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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