सीधे सामग्री पर जाएँ
POST/api/astro/kannada_calendar/1 क्रेडिट

कन्नड़ कैलेंडर

कर्नाटक में मनाए जाने वाले एक वर्ष के त्योहार और पर्व। कन्नड़ कैलेंडर शक संवत पर चलने वाला अमांत चांद्र-सौर कैलेंडर है — महीने एक अमावस्या से अगली अमावस्या तक चलते हैं। इसके त्योहारों में एकादशियाँ, बारह संक्रांतियाँ, ग्रहण और क्षेत्रीय पर्व आते हैं: उगादि, गौरी हब्बा, कामनहब्बा, करगा उत्सव, सकट और करवा चौथ। वर्ष के साथ अक्षांश, देशांतर और UTC ऑफ़सेट भेजें। स्थान इसलिए ज़रूरी है कि कई पर्व सूर्योदय के समय की तिथि या चंद्रोदय से तय होते हैं। उत्तर {year, events} के रूप में मिलता है, जिसमें हर इवेंट {name, date} है, तारीख़ के क्रम में; आमतौर पर सौ से कहीं ज़्यादा प्रविष्टियाँ होती हैं। ग्रहण वाली पंक्तियों के नाम के साथ ग्रहण का प्रकार भी जुड़ा होता है, जैसे 'Surya Grahan *Valayakara'। वर्ष 2006 से 2046 के बीच होना चाहिए।

https://api.occultapi.com/api/astro/kannada_calendar/
अनुरोध आज़माएँ
कन्नड़ कैलेंडर का नतीजा, एक इंटरफ़ेस में
इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
latitudenumber (double)ज़रूरी

स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।

longitudenumber (double)ज़रूरी

स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।

timezone_as_floatnumber (double)ज़रूरी

स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।

yearintegerज़रूरी

जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।

min 2006 · max 2046

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

curl -X POST https://api.occultapi.com/api/astro/kannada_calendar/ \
  -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, \"events\": [{\"name\": \"Sakat Chauth\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Makara Sankranti\", \"date\": \"2026-01-14\"}, {\"name\": \"Pongal\", \"date\": \"2026-01-14\"}, {\"name\": \"Mauni Amavas\", \"date\": \"2026-01-18\"}, {\"name\": \"Vasant Panchami\", \"date\": \"2026-01-23\"}, {\"name\": \"Ratha Saptami\", \"date\": \"2026-01-25\"}, {\"name\": \"Bhishma Ashtami\", \"date\": \"2026-01-26\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Kumbha Sankranti\", \"date\": \"2026-02-13\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Surya Grahan *Valayakara\", \"date\": \"2026-02-17\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Chandra Grahan *Purna\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi Hunnime\", \"date\": \"2026-03-03\"}, {\"name\": \"Kamanahabba\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Sheetala Ashtami\", \"date\": \"2026-03-11\"}, {\"name\": \"Basoda\", \"date\": \"2026-03-11\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Meena Sankranti\", \"date\": \"2026-03-15\"}, {\"name\": \"Nutan Varsh Prarambha\", \"date\": \"2026-03-19\"}, {\"name\": \"Gudi Padwa\", \"date\": \"2026-03-19\"}, {\"name\": \"Chaitra Navratri\", \"date\": \"2026-03-19\"}, {\"name\": \"Yugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Gauri Puja\", \"date\": \"2026-03-21\"}, {\"name\": \"Soubhagya Gauri Vrat\", \"date\": \"2026-03-21\"}, {\"name\": \"Yamuna Chhath\", \"date\": \"2026-03-24\"}, {\"name\": \"Shri Rama Navami\", \"date\": \"2026-03-26\"}, {\"name\": \"Swaminarayan Jayanti\", \"date\": \"2026-03-27\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Karaga Festival\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Jayanti\", \"date\": \"2026-04-02\"}, {\"name\": \"Hanuman Janmotsava\", \"date\": \"2026-04-02\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Mesha Sankranti\", \"date\": \"2026-04-14\"}, {\"name\": \"Solar New Year\", \"date\": \"2026-04-14\"}, {\"name\": \"Parashurama Jayanti\", \"date\": \"2026-04-19\"}, {\"name\": \"Akshaya Tritiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Ganga Saptami\", \"date\": \"2026-04-23\"}, {\"name\": \"Sita Navami\", \"date\": \"2026-04-25\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Narasimha Jayanti\", \"date\": \"2026-04-30\"}, {\"name\": \"Buddha Purnima\", \"date\": \"2026-05-01\"}, {\"name\": \"Narada Jayanti\", \"date\": \"2026-05-02\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Vrishabha Sankranti\", \"date\": \"2026-05-15\"}, {\"name\": \"Vat Savitri Vrat\", \"date\": \"2026-05-16\"}, {\"name\": \"Shani Jayanti\", \"date\": \"2026-05-16\"}, {\"name\": \"Ganga Dussehra\", \"date\": \"2026-05-25\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Mithuna Sankranti\", \"date\": \"2026-06-15\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Vat Purnima Vrat\", \"date\": \"2026-06-29\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Karka Sankranti\", \"date\": \"2026-07-16\"}, {\"name\": \"Jagannath Rathyatra\", \"date\": \"2026-07-16\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Guru Purnima\", \"date\": \"2026-07-29\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Surya Grahan *Purna\", \"date\": \"2026-08-12\"}, {\"name\": \"Hariyali Teej\", \"date\": \"2026-08-15\"}, {\"name\": \"Simha Sankranti\", \"date\": \"2026-08-17\"}, {\"name\": \"Nagara Panchami\", \"date\": \"2026-08-17\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Onam\", \"date\": \"2026-08-26\"}, {\"name\": \"Varalakshmi Vrat\", \"date\": \"2026-08-28\"}, {\"name\": \"Chandra Grahan *Anshika\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Rakhi\", \"date\": \"2026-08-28\"}, {\"name\": \"Gayatri Jayanti\", \"date\": \"2026-08-28\"}, {\"name\": \"Kajari Teej\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Hartalika Teej\", \"date\": \"2026-09-14\"}, {\"name\": \"Gowri Habba\", \"date\": \"2026-09-14\"}, "
}

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

त्रुटियाँ

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