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

तेलुगु कैलेंडर

तेलुगु कैलेंडर अमांत चांद्र-सौर है: महीने एक अमावस्या से अगली अमावस्या तक चलते हैं, उनके नाम तेलुगु में हैं (Chaithramu, Vaisakhamu, Jyesthamu, Ashadhamu, Sravanamu, Bhadhrapadamu, Asvayujamu, Karthikamu, Margasiramu, Pushyamu, Maghamu और Phalgunamu), वर्ष शक संवत में गिना जाता है और Chaithramu शुक्ल पाड्यमी को उगादि से शुरू होता है। महीनों का अंदरूनी गणित, अधिक मास की पहचान समेत, वही है जो मराठी और कन्नड़ कैलेंडर में है — इन तीनों में फ़र्क महीनों के नाम और त्योहारों की सूची का है, खगोलीय गणना का नहीं। यह तमिल और मलयालम कैलेंडरों वाली सौर पद्धति नहीं है, जिसमें महीना एक राशि से अगली राशि तक चलता है। `year` के साथ `latitude`, `longitude` और `timezone_as_float` भेजें। उत्तर `{year, events}` है, और हर घटना केवल `{name, date}` है; तमिल कैलेंडर से अलग, इसमें महीने या महीने के दिन वाले फ़ील्ड नहीं हैं। साल में लगभग नब्बे प्रविष्टियाँ आती हैं: तेलुगु नामों के साथ चौबीस एकादशियाँ (अधिक मास वाले साल में छब्बीस), और अगले दिन वाली गौण व वैष्णव एकादशियाँ भी, जिन्हें ज़्यादातर दूसरे क्षेत्रीय कैलेंडर छोड़ देते हैं; वार के नाम वाले लगभग पच्चीस प्रदोष व्रत (Ravi, Soma, Bhauma, Budha, Guru, Shukra, Shani); बारह संकष्टहर चतुर्थी; बारह शुक्ल द्वादशी व्रत; और मुख्य त्योहार। सूर्योदय, सूर्यास्त और प्रदोष काल आपके भेजे निर्देशांकों के लिए निकाले जाते हैं, इसलिए दूसरे शहर में कोई तारीख़ एक दिन खिसक सकती है; ख़ासकर प्रदोष व्रत का नियम हर त्रयोदशी को उस कैलेंडर दिन पर रखता है जिसके सूर्यास्त के बाद वाले प्रदोष काल से उसका सबसे ज़्यादा मेल हो। मुख्य हिंदू कैलेंडर वाले त्योहार पहले से गणना की गई तालिका से पढ़े जाते हैं, जो केवल 2006-2046 तक है।

https://api.occultapi.com/api/astro/telugu_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/telugu_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\": \"Guru Pradosh Vrat\", \"date\": \"2026-01-01\"}, {\"name\": \"Lambodara Sankashtahara\", \"date\": \"2026-01-06\"}, {\"name\": \"Shattila Ekadashi\", \"date\": \"2026-01-14\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-16\"}, {\"name\": \"Jaya Ekadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Bhishma Dwadashi\", \"date\": \"2026-01-29\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-01-30\"}, {\"name\": \"Dwijapriya Sankashtahara\", \"date\": \"2026-02-05\"}, {\"name\": \"Vijaya Ekadashi\", \"date\": \"2026-02-13\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-02-14\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-02-14\"}, {\"name\": \"Maha Shivaratri\", \"date\": \"2026-02-15\"}, {\"name\": \"Amalaki Ekadashi\", \"date\": \"2026-02-27\"}, {\"name\": \"Narasimha Dwadashi\", \"date\": \"2026-02-28\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-03-01\"}, {\"name\": \"Chhoti Holi\", \"date\": \"2026-03-03\"}, {\"name\": \"Holika Dahan\", \"date\": \"2026-03-03\"}, {\"name\": \"Holi\", \"date\": \"2026-03-04\"}, {\"name\": \"Bhalachandra Sankashtahara\", \"date\": \"2026-03-06\"}, {\"name\": \"Papamochani Ekadashi\", \"date\": \"2026-03-15\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-16\"}, {\"name\": \"Ugadi\", \"date\": \"2026-03-19\"}, {\"name\": \"Dola Gowri Vratam\", \"date\": \"2026-03-21\"}, {\"name\": \"Andolana Trutiya\", \"date\": \"2026-03-21\"}, {\"name\": \"Shree Ramanavami\", \"date\": \"2026-03-26\"}, {\"name\": \"Kamada Ekadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Vamana Dwadashi\", \"date\": \"2026-03-29\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-03-30\"}, {\"name\": \"Madana Pournami\", \"date\": \"2026-04-02\"}, {\"name\": \"Vikata Sankashtahara\", \"date\": \"2026-04-05\"}, {\"name\": \"Varuthini Ekadashi\", \"date\": \"2026-04-13\"}, {\"name\": \"Budha Pradosh Vrat\", \"date\": \"2026-04-15\"}, {\"name\": \"Akshaya Trutiya\", \"date\": \"2026-04-19\"}, {\"name\": \"Mohini Ekadashi\", \"date\": \"2026-04-27\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-04-28\"}, {\"name\": \"Parashurama Dwadashi\", \"date\": \"2026-04-28\"}, {\"name\": \"Ekadanta Sankashtahara\", \"date\": \"2026-05-05\"}, {\"name\": \"Hanuman Jayanthi\", \"date\": \"2026-05-12\"}, {\"name\": \"Apara Ekadashi\", \"date\": \"2026-05-13\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-14\"}, {\"name\": \"Adhika Ramalakshmana Dwadashi\", \"date\": \"2026-05-27\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\": \"2026-05-28\"}, {\"name\": \"Vibhuvana Sankashtahara\", \"date\": \"2026-06-03\"}, {\"name\": \"Parama Ekadashi\", \"date\": \"2026-06-11\"}, {\"name\": \"Shukra Pradosh Vrat\", \"date\": \"2026-06-12\"}, {\"name\": \"Nirjala Ekadashi\", \"date\": \"2026-06-25\"}, {\"name\": \"Ramalakshmana Dwadashi\", \"date\": \"2026-06-26\"}, {\"name\": \"Shani Trayodashi\", \"date\": \"2026-06-27\"}, {\"name\": \"Shani Pradosh Vrat\", \"date\": \"2026-06-27\"}, {\"name\": \"Krishnapingala Sankashtahara\", \"date\": \"2026-07-03\"}, {\"name\": \"Yogini Ekadashi\", \"date\": \"2026-07-10\"}, {\"name\": \"Gauna Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Vaishnava Yogini Ekadashi\", \"date\": \"2026-07-11\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-12\"}, {\"name\": \"Devshayani Ekadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Vasudeva Dwadashi\", \"date\": \"2026-07-25\"}, {\"name\": \"Ravi Pradosh Vrat\", \"date\": \"2026-07-26\"}, {\"name\": \"Gajanana Sankashtahara\", \"date\": \"2026-08-02\"}, {\"name\": \"Kamika Ekadashi\", \"date\": \"2026-08-09\"}, {\"name\": \"Soma Pradosh Vrat\", \"date\": \"2026-08-10\"}, {\"name\": \"Shravana Putrada Ekadashi\", \"date\": \"2026-08-23\"}, {\"name\": \"Vaishnava Shravana Putrada Ekadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Damodara Dwadashi\", \"date\": \"2026-08-24\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-08-25\"}, {\"name\": \"Varalakshmi Vratam\", \"date\": \"2026-08-28\"}, {\"name\": \"Raksha Bandhan\", \"date\": \"2026-08-28\"}, {\"name\": \"Heramba Sankashtahara\", \"date\": \"2026-08-31\"}, {\"name\": \"Krishna Janmashtami\", \"date\": \"2026-09-04\"}, {\"name\": \"Aja Ekadashi\", \"date\": \"2026-09-07\"}, {\"name\": \"Bhauma Pradosh Vrat\", \"date\": \"2026-09-08\"}, {\"name\": \"Ganesh Chaturthi\", \"date\": \"2026-09-14\"}, {\"name\": \"Parivartani Ekadashi\", \"date\": \"2026-09-22\"}, {\"name\": \"Kalki Dwadashi\", \"date\": \"2026-09-23\"}, {\"name\": \"Guru Pradosh Vrat\", \"date\":"
}

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

त्रुटियाँ

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