/api/astro/yoga_scan/1 क्रेडिटनित्य योग का वार्षिक स्कैन
नित्य योग, सूर्य और चंद्रमा के निरयन भोगांशों के जोड़ से बने वृत्त का सत्ताईसवाँ भाग है। सत्ताईस योगों में से हर एक — विष्कंभ से वैधृति तक — एक दिन से थोड़ा कम चलता है, और मुहूर्त चुनने में इनका महत्व है: व्यतीपात, वैधृति, परिघ, व्याघात, शूल, गंड और अतिगंड पारंपरिक रूप से टाले जाते हैं, जबकि सिद्धि, सिद्ध, शुभ, अमृत वर्ग के और सुकर्मा योग ढूँढे जाते हैं। यह एंडपॉइंट नाम से एक योग लेता है और कैलेंडर वर्ष में वह जितनी बार आता है, हर बार की अवधि लौटाता है। `yoga_name` केस-संवेदी है और enum से हूबहू मेल खाना चाहिए। `year` और `timezone_as_float` तय करते हैं कि कौन-सा स्थानीय वर्ष देखना है; निर्देशांक नहीं चाहिए, क्योंकि योग हर जगह एक ही क्षण बदलता है। दोनों भोगांशों का जोड़ हर 22.6 घंटे में लगभग 13 अंश 20 कला बढ़ता है, इसलिए हर योग साल में लगभग चौदह या पंद्रह बार आता है। उत्तर `{year, yoga_name, rows}` है, जिसमें `rows` समय के क्रम में `{start, end}` की सूची है, UTC ISO टाइमस्टैम्प में। हर जोड़ा उस योग के शुरू और ख़त्म होने का असली क्षण है, जो सूर्योदय के समय का नमूना लेकर नहीं, सूर्य और चंद्रमा के भोगांशों के जोड़ पर द्विभाजन (bisection) से निकाला जाता है, इसलिए सीमाएँ एक सेकंड के अंश तक सटीक होती हैं।
https://api.occultapi.com/api/astro/yoga_scan/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। |
| year | integer | ज़रूरी | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400 |
| yoga_name | string | ज़रूरी | VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/yoga_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"timezone_as_float":5.5,"year":2026,"yoga_name":"Vishkambha"}'उत्तर
{
"data": {
"year": 2026,
"yoga_name": "Vishkambha",
"rows": [
{
"start": "2026-01-04T20:17:27.999999+00:00",
"end": "2026-01-05T17:17:16.999999+00:00"
},
{
"start": "2026-01-30T11:28:35.999999+00:00",
"end": "2026-01-31T08:03:35.999999+00:00"
},
{
"start": "2026-02-24T22:56:20.999999+00:00",
"end": "2026-02-25T19:58:43.999999+00:00"
},
{
"start": "2026-03-22T10:11:35.999999+00:00",
"end": "2026-03-23T06:52:06.999999+00:00"
},
{
"start": "2026-04-17T01:51:55.999999+00:00",
"end": "2026-04-17T22:15:28.999999+00:00"
},
{
"start": "2026-05-12T17:49:31.999999+00:00",
"end": "2026-05-13T15:24:49.999999+00:00"
},
{
"start": "2026-06-07T04:31:57.999999+00:00",
"end": "2026-06-08T03:58:13.999999+00:00"
},
{
"start": "2026-07-02T11:09:21.999999+00:00",
"end": "2026-07-03T11:30:01.999999+00:00"
},
{
"start": "2026-07-27T17:24:55.999999+00:00",
"end": "2026-07-28T18:03:37.999999+00:00"
},
{
"start": "2026-08-21T23:48:40.999999+00:00",
"end": "2026-08-23T00:44:33.999999+00:00"
},
{
"start": "2026-09-16T06:52:40.999999+00:00",
"end": "2026-09-17T07:19:46.999999+00:00"
},
{
"start": "2026-10-11T15:35:35.999999+00:00",
"end": "2026-10-12T15:02:25.999999+00:00"
},
{
"start": "2026-11-05T23:39:40.999999+00:00",
"end": "2026-11-06T22:40:11.999999+00:00"
},
{
"start": "2026-12-01T06:45:12.999999+00:00",
"end": "2026-12-02T05:01:50.999999+00:00"
},
{
"start": "2026-12-26T18:52:33.999999+00:00",
"end": "2026-12-27T15:23:47.999999+00:00"
}
]
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।