/api/astro/tamil_calendar/1 krediTamil takvimi
Tamil takvimi kameri değil güneş takvimidir; onu buradaki bölgesel takvimlerin çoğundan ayıran da budur. Bir ay, Güneş yeni bir sideral burca girdiği anda başlar; bu yüzden on iki ay (Chithirai, Vaikasi, Aani, Aadi, Aavani, Purattasi, Aippasi, Karthigai, Margazhi, Thai, Maasi ve Panguni) Güneş'in konumunu izler ve her yıl yaklaşık aynı Gregoryen tarihlerde başlar; yılı 14 Nisan civarında Chithirai ayı açar. Bir ayın ilk günü gün batımı kuralıyla belirlenir: Güneş'in burca girişi gün doğumu ile gün batımı arasına düşerse o takvim günü ayın ilk günüdür; gün batımından sonraya düşerse ertesi gün ilk gün olur. Buna karşılık Telugu, Marathi, Gujarati ve Kannada takvimleri ayları yeni aydan veya dolunaydan sayar. `year` değerini `latitude`, `longitude` ve `timezone_as_float` ile birlikte POST edin. Her dini günün belirlenmesinde kullanılan gün doğumu ve gün batımı bu koordinatlar için hesaplanır; bu yüzden konumu değiştirirseniz bir olay bir gün kayabilir. Yanıt `{year, events}` biçimindedir; her olay `{name, date, tamil_month, tamil_day}` biçimindedir (Gregoryen tarih ve Tamil ayı içindeki konum) ve liste tüm Gregoryen yılı kapsar. Pongal, Puthandu, Thai Pusam, Masi Magam, Panguni Uthiram, Aadi Perukku, Karadaiyan Nombu, Ayutha Poojai ve diğerleri Tamil adlarıyla yer alır. Bu bayramların bir kısmı, ana Hindu bayram motorunun hesapladığı kameri tithilerin aynısıdır; Tamil adıyla aranır ve ardından kendi dini gün kuralına (sunrise, madhyahna, aparahna, nishita, pradosha veya purvahna) göre belirlenir. Bunlar önceden hesaplanmış bayram tablosundan geldiği için bu endpoint 2006-2046 yıllarıyla sınırlıdır. Birkaç giriş tahminle doldurulmak yerine bilerek dışarıda bırakılmıştır; bunlar arasında Agni Nakshatram, Vedaya özgü üç Avani Avittam tarihi, Gayathri Japam ve Agastya Arghya vardır.
https://api.occultapi.com/api/astro/tamil_calendar/
Kimlik doğrulama
Anahtarınızı X-API-Key başlığında gönderin. Anahtar, sunucu tarafında saklanması gereken bir kimlik bilgisidir; tarayıcıda çalışan JavaScript'e veya mobil uygulamaya asla koymayın.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonİstek alanları
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| latitude | number (double) | zorunlu | Yerin enlemi, ondalık derece cinsinden. Pozitif değer kuzeyi, negatif değer güneyi gösterir. Örnek: Jaipur için 26.9124, New York için 40.7128. Dakika ve saniye kabul edilmez - önce ondalık dereceye çevirin. |
| longitude | number (double) | zorunlu | Yerin boylamı, ondalık derece cinsinden. Pozitif değer doğuyu, negatif değer batıyı gösterir. Örnek: Jaipur için 75.7873, New York için -74.0060. İşarete dikkat edin: eksi işaretini unutursanız New York Çin'e düşer. |
| timezone_as_float | number (double) | zorunlu | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30), kışın New York için -5, Nepal için 5.75. Bu değer date_time ile karşılaştırılıp DOĞRULANMAZ - ikisi birbirini tutmazsa yanlış an için başarılı bir yanıt alırsınız; bu yüzden ikisini de aynı kaynaktan alın. Bugünkü farkı değil, o tarihte geçerli olan farkı kullanın: yaz saati uygulayan bir ülkede yaz aylarında doğan biri için yaz saati farkı gerekir. |
| year | integer | zorunlu | Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı. min 2006 · max 2046 |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/tamil_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}'Yanıt
{
"data": {
"year": 2026,
"events": [
{
"name": "Arudra Darshan",
"date": "2026-01-03",
"tamil_month": "Margazhi",
"tamil_day": 19
},
{
"name": "Bhogi Pandigai",
"date": "2026-01-13",
"tamil_month": "Margazhi",
"tamil_day": 29
},
{
"name": "Pongal",
"date": "2026-01-14",
"tamil_month": "Thai",
"tamil_day": 1
},
{
"name": "Mattu Pongal",
"date": "2026-01-15",
"tamil_month": "Thai",
"tamil_day": 2
},
{
"name": "Thai Amavasai",
"date": "2026-01-18",
"tamil_month": "Thai",
"tamil_day": 5
},
{
"name": "Ratha Sapthami",
"date": "2026-01-25",
"tamil_month": "Thai",
"tamil_day": 12
},
{
"name": "Thai Pusam",
"date": "2026-02-01",
"tamil_month": "Thai",
"tamil_day": 19
},
{
"name": "Shivaratri",
"date": "2026-02-15",
"tamil_month": "Maasi",
"tamil_day": 3
},
{
"name": "Masi Magam",
"date": "2026-03-03",
"tamil_month": "Maasi",
"tamil_day": 19
},
{
"name": "Karadaiyan Nombu",
"date": "2026-03-14",
"tamil_month": "Maasi",
"tamil_day": 30
},
{
"name": "Ugadi - Telugu New Year",
"date": "2026-03-19",
"tamil_month": "Panguni",
"tamil_day": 5
},
{
"name": "Rama Navami *Smarta",
"date": "2026-03-26",
"tamil_month": "Panguni",
"tamil_day": 12
},
{
"name": "Panguni Uthiram",
"date": "2026-04-01",
"tamil_month": "Panguni",
"tamil_day": 18
},
{
"name": "Puthandu",
"date": "2026-04-14",
"tamil_month": "Chithirai",
"tamil_day": 1
},
{
"name": "Vishu",
"date": "2026-04-15",
"tamil_month": "Chithirai",
"tamil_day": 2
},
{
"name": "Akshaya Thiruthiyai",
"date": "2026-04-19",
"tamil_month": "Chithirai",
"tamil_day": 6
},
{
"name": "Sankara Jayanthi",
"date": "2026-04-21",
"tamil_month": "Chithirai",
"tamil_day": 8
},
{
"name": "Ramanuja Jayanthi",
"date": "2026-04-22",
"tamil_month": "Chithirai",
"tamil_day": 9
},
{
"name": "Chitra Pournami",
"date": "2026-05-01",
"tamil_month": "Chithirai",
"tamil_day": 18
},
{
"name": "Vaikasi Visakam",
"date": "2026-05-30",
"tamil_month": "Vaikasi",
"tamil_day": 16
},
{
"name": "Aadi Perukku",
"date": "2026-08-03",
"tamil_month": "Aadi",
"tamil_day": 18
},
{
"name": "Aadi Amavasai",
"date": "2026-08-12",
"tamil_month": "Aadi",
"tamil_day": 27
},
{
"name": "Andal Jayanthi",
"date": "2026-08-14",
"tamil_month": "Aadi",
"tamil_day": 29
},
{
"name": "Gokulastami",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Astami Rohini",
"date": "2026-09-04",
"tamil_month": "Aavani",
"tamil_day": 19
},
{
"name": "Vinayagar Chathurthi",
"date": "2026-09-14",
"tamil_month": "Aavani",
"tamil_day": 29
},
{
"name": "Mahalaya Amavasai",
"date": "2026-10-10",
"tamil_month": "Purattasi",
"tamil_day": 24
},
{
"name": "Navarathiri",
"date": "2026-10-11",
"tamil_month": "Purattasi",
"tamil_day": 25
},
{
"name": "Ayutha Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Saraswati Poojai",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vijaya Dashami",
"date": "2026-10-20",
"tamil_month": "Aippasi",
"tamil_day": 3
},
{
"name": "Vidyarambham",
"date": "2026-10-21",
"tamil_month": "Aippasi",
"tamil_day": 4
},
{
"name": "Lakshmi Puja",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Kedara Gowri Vratham",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Deepavali",
"date": "2026-11-08",
"tamil_month": "Aippasi",
"tamil_day": 22
},
{
"name": "Karthigai Deepam",
"date": "2026-11-24",
"tamil_month": "Karthigai",
"tamil_day": 8
},
{
"name": "Subrahmanya Sashti",
"date": "2026-12-15",
"tamil_month": "Karthigai",
"tamil_day": 29
},
{
"name": "Vaikuntha Ekadashi",
"date": "2026-12-20",
"tamil_month": "Margazhi",
"tamil_day": 5
},
{
"name": "Arudra Darshan",
"date": "2026-12-24",
"tamil_month": "Margazhi",
"tamil_day": 9
}
]
},
"message": "successful",
"is_error": false
}Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında yer alır.
Hatalar
Kredi ve kullanım hataları { "error": "…", "message": "<code>", "is_error": true } döndürür. Kullanıcıya error değerini gösterin, kodunuzda ise message değerine göre karar verin. Ayrıntılar için hata referansına bakın.