POST/api/astro/iskcon_calendar/1 kredi

ISKCON takvimi

ISKCON'un izlediği Vaishnava takvimi: yılın tüm Ekadashi'leri, acharyaların dünyaya geliş ve ayrılış günleri ve büyük bayramlar. Tarihler genel Hindu hesabına göre değil, Gaudiya hesabına göre belirlenir. Aylar Vishnu'nun on iki adını taşır — Madhava, Govinda, Damodara ve diğerleri —, iki yarım ay Krishna ve Gaura adını alır, yıllar da Gaurabda çağına göre sayılır. Yılı enlem, boylam ve UTC farkıyla birlikte gönderin; bir dini günün hangi takvim gününe düşeceğini yerel gün doğumunda geçerli olan tithi belirler. Yanıt {year, events} biçimindedir ve her olay {name, date, masa, paksa, tithi_number, is_adhika, gaurabda_year} yapısındadır. Böylece hem Gregoryen tarihi hem de bu tarihi veren Vaishnava koordinatlarını alırsınız; is_adhika, artık aya denk gelen olayları işaretler. Tithi ve ay hesabı, ISKCON'un kendi takvim yazılımının kullandığı GCAL spesifikasyonunu izler. Bu yöntem, /api/astro/panchanga/ endpoint'inin dayandığı sideral efemeris yönteminden bilinçli olarak farklıdır; bu yüzden tarihler buradaki diğer endpoint'lerle bir gün farklı çıkabilir. Bir yıl birkaç yüz olay döndürür; filtrelemeyi veya sayfalamayı istemci tarafında yapın.

https://api.occultapi.com/api/astro/iskcon_calendar/

İsteği deneyin

ISKCON takvimi çıktısı bir arayüzde — Bu endpoint'in verileri, canlı bir arayüzde. Değerleri API verir; ekran düzenini siz kurarsınız.

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 1800 · max 2400

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/iskcon_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

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"events\": [{\"name\": \"Shri Krishna Pushya Abhisheka\", \"date\": \"2026-01-03\", \"masa\": \"Narayana\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramachandra Kaviraja - Disappearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Gopala Bhatta Goswami - Appearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Jayadeva Goswami - Disappearance\", \"date\": \"2026-01-08\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 6, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Lochana Dasa Thakura - Disappearance\", \"date\": \"2026-01-09\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shat Tila Ekadashi\", \"date\": \"2026-01-14\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Sarasvati Puja\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Pundarika Vidyanidhi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Raghunandana Thakura - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Raghunatha Dasa Goswami - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Vishwanatha Chakravarti Thakura - Disappearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrimati Vishnupriya Devi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Vasanta Panchami\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Advaita Acharya - Appearance\", \"date\": \"2026-01-25\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhishmashtami\", \"date\": \"2026-01-26\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 8, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Madhvacharya - Disappearance\", \"date\": \"2026-01-27\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 9, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramanujacharya - Disappearance\", \"date\": \"2026-01-28\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 10, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhaimi Ekadashi\", \"date\": \"2026-01-29\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Varaha Dwadashi\", \"date\": \"2026-01-30\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 12, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Nityananda Trayodashi\", \"date\": \"2026-01-31\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 13, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Krishna Madhura Utsava\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Narottama Dasa Thakura - Appearance\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Purushottama Dasa Thakura - Disappearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Bhaktisiddhanta Sarasvati Thakura - Appearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_"
}

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.