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

रवि योग की अवधियाँ

रवि योग तब बनता है जब चंद्रमा का नक्षत्र सूर्य के नक्षत्र से 4, 6, 9, 10, 13 या 20 स्थान की दूरी पर हो। इसे ऐसी शुभ अवधि माना जाता है जो वैसे प्रतिकूल मुहूर्त पर भी भारी पड़ती है, और आमतौर पर गृह प्रवेश, नए वाहन की डिलीवरी लेने, दुकान खोलने जैसे एक बार किए जाने वाले कामों के लिए देखी जाती है। यह केवल दोनों नक्षत्रों पर निर्भर है, तिथि या वार पर नहीं, इसलिए इसे दिन के फ़्लैग की जगह सटीक समय वाली लगातार अवधियों के रूप में दिया जा सकता है। उत्तर `data.rows` है: माँगे गए पूरे वर्ष की `{start, end}` अवधियों की सूची, UTC में ISO 8601 टाइमस्टैम्प के साथ। अवधि के भीतर पड़ने वाले हर सूर्योदय पर उसे काटा जाता है, इसलिए तीन दिन की एक लगातार अवधि तीन क्रमागत पंक्तियों में आती है, जो सूर्योदय के क्षणों पर आपस में मिलती हैं, ठीक वैसे जैसे Drik Panchang दिखाता है। पूरी अवधियाँ वापस चाहिए तो सटी हुई पंक्तियों को जोड़ लें। `year`, `latitude`, `longitude` और `timezone_as_float` भेजें। स्थान का असर केवल सूर्योदय वाले कटाव बिंदुओं पर पड़ता है, योग पर नहीं। `/api/astro/panchanga_yogas/` यही योग दिन-स्तर के फ़्लैग के रूप में, तिथि और वार पर निर्भर योगों के साथ बताता है; सटीक आरंभ और अंत समय चाहिए तो यह एंडपॉइंट इस्तेमाल करें।

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

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

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

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
latitude	number (double)	ज़रूरी	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	ज़रूरी	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
timezone_as_float	number (double)	ज़रूरी	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।
end_date	string (date)	वैकल्पिक
start_date	string (date)	वैकल्पिक
year	integer	वैकल्पिक	जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400

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

curl -X POST https://api.occultapi.com/api/astro/ravi_yoga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

उत्तर

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"rows\": [{\"start\": \"2026-01-01T17:18:35+00:00\", \"end\": \"2026-01-02T01:50:16+00:00\"}, {\"start\": \"2026-01-02T01:50:16+00:00\", \"end\": \"2026-01-02T14:34:10+00:00\"}, {\"start\": \"2026-01-08T06:54:39+00:00\", \"end\": \"2026-01-09T01:51:24+00:00\"}, {\"start\": \"2026-01-09T01:51:24+00:00\", \"end\": \"2026-01-09T08:10:56+00:00\"}, {\"start\": \"2026-01-25T02:19:01+00:00\", \"end\": \"2026-01-25T08:05:57+00:00\"}, {\"start\": \"2026-01-27T05:39:05+00:00\", \"end\": \"2026-01-28T01:48:11+00:00\"}, {\"start\": \"2026-01-28T01:48:11+00:00\", \"end\": \"2026-01-29T01:47:45+00:00\"}, {\"start\": \"2026-01-29T01:47:45+00:00\", \"end\": \"2026-01-29T02:01:52+00:00\"}, {\"start\": \"2026-01-30T21:57:34+00:00\", \"end\": \"2026-01-31T01:46:50+00:00\"}, {\"start\": \"2026-01-31T01:46:50+00:00\", \"end\": \"2026-01-31T20:04:13+00:00\"}, {\"start\": \"2026-02-07T20:58:37+00:00\", \"end\": \"2026-02-08T01:42:18+00:00\"}, {\"start\": \"2026-02-08T01:42:18+00:00\", \"end\": \"2026-02-08T23:32:55+00:00\"}, {\"start\": \"2026-02-20T14:37:39+00:00\", \"end\": \"2026-02-21T01:32:17+00:00\"}, {\"start\": \"2026-02-21T01:32:17+00:00\", \"end\": \"2026-02-21T13:37:16+00:00\"}, {\"start\": \"2026-02-22T12:24:48+00:00\", \"end\": \"2026-02-23T01:30:30+00:00\"}, {\"start\": \"2026-02-23T01:30:30+00:00\", \"end\": \"2026-02-23T11:03:45+00:00\"}, {\"start\": \"2026-02-25T08:08:55+00:00\", \"end\": \"2026-02-26T01:27:44+00:00\"}, {\"start\": \"2026-02-26T01:27:44+00:00\", \"end\": \"2026-02-27T01:26:47+00:00\"}, {\"start\": \"2026-02-27T01:26:47+00:00\", \"end\": \"2026-02-27T05:19:02+00:00\"}, {\"start\": \"2026-03-01T03:04:29+00:00\", \"end\": \"2026-03-02T01:23:52+00:00\"}, {\"start\": \"2026-03-02T01:23:52+00:00\", \"end\": \"2026-03-02T02:21:41+00:00\"}, {\"start\": \"2026-03-09T10:41:41+00:00\", \"end\": \"2026-03-10T01:15:40+00:00\"}, {\"start\": \"2026-03-10T01:15:40+00:00\", \"end\": \"2026-03-10T13:35:20+00:00\"}, {\"start\": \"2026-03-21T19:07:56+00:00\", \"end\": \"2026-03-22T01:02:41+00:00\"}, {\"start\": \"2026-03-22T01:02:41+00:00\", \"end\": \"2026-03-22T17:12:49+00:00\"}, {\"start\": \"2026-03-23T15:19:47+00:00\", \"end\": \"2026-03-24T01:00:29+00:00\"}, {\"start\": \"2026-03-24T01:00:29+00:00\", \"end\": \"2026-03-24T13:35:03+00:00\"}, {\"start\": \"2026-03-26T10:49:16+00:00\", \"end\": \"2026-03-27T00:57:11+00:00\"}, {\"start\": \"2026-03-27T00:57:11+00:00\", \"end\": \"2026-03-28T00:56:05+00:00\"}, {\"start\": \"2026-03-28T00:56:05+00:00\", \"end\": \"2026-03-28T09:20:23+00:00\"}, {\"start\": \"2026-03-30T09:18:08+00:00\", \"end\": \"2026-03-31T00:52:48+00:00\"}, {\"start\": \"2026-03-31T00:52:48+00:00\", \"end\": \"2026-03-31T09:51:03+00:00\"}, {\"start\": \"2026-03-31T14:40:06+00:00\", \"end\": \"2026-04-01T00:51:43+00:00\"}, {\"start\": \"2026-04-01T00:51:43+00:00\", \"end\": \"2026-04-01T10:47:41+00:00\"}, {\"start\": \"2026-04-08T00:24:04+00:00\", \"end\": \"2026-04-08T00:44:13+00:00\"}, {\"start\": \"2026-04-08T00:44:13+00:00\", \"end\": \"2026-04-09T00:43:10+00:00\"}, {\"start\": \"2026-04-09T00:43:10+00:00\", \"end\": \"2026-04-09T03:18:37+00:00\"}, {\"start\": \"2026-04-19T23:05:23+00:00\", \"end\": \"2026-04-20T00:32:13+00:00\"}, {\"start\": \"2026-04-20T00:32:13+00:00\", \"end\": \"2026-04-20T20:38:33+00:00\"}, {\"start\": \"2026-04-21T18:28:41+00:00\", \"end\": \"2026-04-22T00:30:22+00:00\"}, {\"start\": \"2026-04-22T00:30:22+00:00\", \"end\": \"2026-04-22T16:43:13+00:00\"}, {\"start\": \"2026-04-24T14:44:34+00:00\", \"end\": \"2026-04-25T00:27:40+00:00\"}, {\"start\": \"2026-04-25T00:27:40+00:00\", \"end\": \"2026-04-26T00:26:48+00:00\"}, {\"start\": \"2026-04-26T00:26:48+00:00\", \"end\": \"2026-04-26T14:57:21+00:00\"}, {\"start\": \"2026-04-29T18:46:34+00:00\", \"end\": \"2026-04-30T00:23:28+00:00\"}, {\"start\": \"2026-04-30T00:23:28+00:00\", \"end\": \"2026-04-30T20:46:58+00:00\"}, {\"start\": \"2026-05-07T13:15:59+00:00\", \"end\": \"2026-05-08T00:17:33+00:00\"}, {\"start\": \"2026-05-08T00:17:33+00:00\", \"end\": \"2026-05-08T09:13:55+00:00\"}, {\"start\": \"2026-05-19T03:11:45+00:00\", \"end\": \"2026-05-20T00:10:54+00:00\"}, {\"start\": \"2026-05-20T00:10:54+00:00\", \"end\": \"2026-05-20T00:42:03+00:00\"}, {\"start\": \"2026-05-20T22:42:18+00:00\", \"end\": \"2026-05-21T00:10:29+00:00\"}, {\"start\": \"2026-05-21T00:10:29+00:00\", \"end\": \"2026-05-21T21:19:37+00:00\"}, {\"start\": \"2026"
}

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

त्रुटियाँ

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