/api/astro/retrograde/1 क्रेडिटवक्री अवधियाँ
एक वर्ष की सभी वक्री अवधियाँ, एक छोटे-से उत्तर में। वक्री गति का अर्थ है तारों की पृष्ठभूमि में ग्रह का पीछे की ओर चलता दिखना, और ज्योतिष में इन अवधियों को ग्रह के व्यवहार का एक अलग दौर माना जाता है। केवल `year` भेजें, और कुछ नहीं। उत्तर `data.planets` है: एक ऑब्जेक्ट जिसकी keys ग्रहों के नाम हैं, और हर ग्रह के लिए UTC में `{start, end}` टाइमस्टैम्प की सूची। जो अवधियाँ वर्ष की सीमा पार करती हैं, वे 1 जनवरी और 31 दिसंबर पर काट दी जाती हैं, इसलिए `01-01 00:00:00` से शुरू होने वाली अवधि असल में पिछले वर्ष में शुरू हुई थी। जो ग्रह उस वर्ष वक्री नहीं होता, उसकी सूची खाली मिलती है। दस keys मिलती हैं: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu और ketu। सूर्य और चंद्रमा शामिल नहीं हैं, क्योंकि पृथ्वी से देखने पर वे कभी वक्री नहीं होते। राहु और केतु मध्यम राहु (चंद्र पात) से निकाले जाते हैं, जो पूरे वर्ष बिना स्तंभन के लगातार पीछे की ओर चलता है, इसलिए दोनों के लिए हमेशा पूरे वर्ष की एक ही अवधि दिखती है; स्पष्ट राहु लेने पर कुछ-कुछ दिनों की दर्जनों बेमतलब प्रविष्टियाँ बन जातीं। स्तंभन का समय निकालने के लिए पहले वह दिन पकड़ा जाता है जिसमें भोगांश गति का चिह्न बदलता है, फिर उसी दिन के भीतर समय को और सटीक किया जाता है, इसलिए यह एक मिनट से भी काफ़ी कम तक सटीक होता है। यही आँकड़े `/api/planetary_details/` में आठ और गणनाओं के साथ भी मिलते हैं; यह एंडपॉइंट केवल वक्री डेटा लौटाता है।
https://api.occultapi.com/api/astro/retrograde/
ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| year | integer | ज़रूरी | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'उत्तर
{
"data": {
"year": 2026,
"planets": {
"mercury": [
{
"start": "2026-02-26 06:47:34",
"end": "2026-03-20 19:33:02"
},
{
"start": "2026-06-29 17:34:35",
"end": "2026-07-23 22:58:49"
},
{
"start": "2026-10-24 07:12:44",
"end": "2026-11-13 15:54:27"
}
],
"venus": [
{
"start": "2026-10-03 07:13:14",
"end": "2026-11-14 00:29:50"
}
],
"mars": [],
"jupiter": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-03-11 03:53:41"
},
{
"start": "2026-12-13 00:30:39",
"end": "2026-12-31 00:00:00"
}
],
"saturn": [
{
"start": "2026-07-26 18:57:26",
"end": "2026-12-11 00:30:23"
}
],
"uranus": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-02-04 02:56:33"
},
{
"start": "2026-09-10 18:24:34",
"end": "2026-12-31 00:00:00"
}
],
"neptune": [
{
"start": "2026-07-07 09:57:49",
"end": "2026-12-13 00:46:51"
}
],
"pluto": [
{
"start": "2026-05-06 12:13:55",
"end": "2026-10-16 05:33:46"
}
],
"rahu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
],
"ketu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
]
}
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।