/api/astro/karana_scan/1 क्रेडिटकरण स्कैन
करण आधी तिथि होता है — सूर्य से चंद्रमा की दूरी के छह अंश, यानी लगभग ग्यारह से तेरह घंटे। करणों के ग्यारह नाम हैं: सात चर करण, जिनमें से हर एक चांद्र मास में आठ बार आता है, और चार स्थिर करण, जो एक-एक बार आते हैं। विष्टि, जिसे आमतौर पर भद्रा कहते हैं, वह करण है जिससे बचा जाता है। यह एंडपॉइंट पूरे कैलेंडर वर्ष में किसी एक करण के हर आगमन को खोजता है, ताकि आप वर्ष को दिन-ब-दिन देखे बिना 'अगली विष्टि कब है' जैसी सूची बना सकें। karana_name ठीक उसी वर्तनी में भेजें जो फ़ील्ड की सूची में है (यह केस-संवेदी है), साथ में year और timezone_as_float; ऑफ़सेट से तय होता है कि स्थानीय वर्ष कब शुरू और कब ख़त्म होता है। अक्षांश या देशांतर की ज़रूरत नहीं, क्योंकि करण पूरी तरह चंद्रमा की गति पर आधारित है। उत्तर {year, karana_name, rows} के रूप में मिलता है, जहाँ rows UTC में {start, end} टाइमस्टैम्प की कालक्रम वाली सूची है। स्थिर करण के लिए वर्ष में लगभग बारह पंक्तियाँ आती हैं और चर करण के लिए लगभग सौ। एक दिन के करणों के लिए इसके बजाय /api/astro/panchanga/ की karana_segments key इस्तेमाल करें।
https://api.occultapi.com/api/astro/karana_scan/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| karana_name | string | ज़रूरी | KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga |
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। |
| year | integer | ज़रूरी | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/karana_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"karana_name":"Kimstughna","timezone_as_float":5.5,"year":2026}'उत्तर
{
"data": {
"year": 2026,
"karana_name": "Kimstughna",
"rows": [
{
"start": "2026-01-18T19:52:39+00:00",
"end": "2026-01-19T08:22:04+00:00"
},
{
"start": "2026-02-17T12:01:47+00:00",
"end": "2026-02-17T23:48:42+00:00"
},
{
"start": "2026-03-19T01:24:05+00:00",
"end": "2026-03-19T12:26:49+00:00"
},
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-04-17T22:18:56+00:00"
},
{
"start": "2026-05-16T20:01:32+00:00",
"end": "2026-05-17T06:07:05+00:00"
},
{
"start": "2026-06-15T02:54:39+00:00",
"end": "2026-06-15T12:57:08+00:00"
},
{
"start": "2026-07-14T09:44:04+00:00",
"end": "2026-07-14T20:00:36+00:00"
},
{
"start": "2026-08-12T17:37:11+00:00",
"end": "2026-08-13T04:21:33+00:00"
},
{
"start": "2026-09-11T03:27:28+00:00",
"end": "2026-09-11T14:48:43+00:00"
},
{
"start": "2026-10-10T15:50:36+00:00",
"end": "2026-10-11T03:52:40+00:00"
},
{
"start": "2026-11-09T07:02:42+00:00",
"end": "2026-11-09T19:43:50+00:00"
},
{
"start": "2026-12-09T00:52:31+00:00",
"end": "2026-12-09T14:03:05+00:00"
}
]
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।