İçeriğe atla
Occult API
POST/api/festivals/1 kredi

Bayram takvimi (önceden hesaplanmış)

Dört gelenek için önceden hesaplanmış bayram tarihleri. Tarihler istek sırasında hesaplanmaz, doğrudan bir tablodan okunur; böylece bir yılın tamamı tek bir indeksli sorguyla döner. `keys` hangi listeleri istediğinizi belirler: `festivals` ana Hindu takvimidir, `ekadashis` yılın her biri adıyla verilen yirmi dört veya yirmi altı Ekadashi'sidir; `jain_festivals`, `sikh_festivals` ve `christian_festivals` ise ilgili takvimlerdir. `year` zorunludur, `month` (1-12) isteğe bağlıdır; yılın tamamı için ayı göndermeyin. Yanıt, istenen her kategoriye göre anahtarlanmış `{data}` biçimindedir ve her kategori kronolojik bir olay listesi içerir. Her olayda şunlar bulunur: `name`, `name_hi` (Hintçe karşılığı; şu anda yalnızca ana Hindu kategorisinde doludur, diğerlerinde null), `month` (kameri ay adı), `paksha`, `tithi` (Sih listesinde kullanılır), `date` (Hristiyan bayramları gibi sabit bir takvim tarihine düşen günlerde kullanılır) ve ilgili tithinin başladığı ve bittiği kesin anları veren `start_time`/`end_time`. Tarihler 2006 ile 2046 (dahil) arasındaki yıllar için önceden hesaplanmıştır. Bu aralığın dışındaki istekler hata değil, boş liste döndürür. Satırlar her istekte hesaplanmayıp saklandığı için bu endpoint koordinat almaz; konuma göre değişen bir dini gün gerekiyorsa, her bayramı yerel gün doğumu ve gün batımına göre bir takvim gününe yerleştiren bölgesel takvim endpoint'lerini kullanın.

https://api.occultapi.com/api/festivals/
İsteği deneyin
Bayram takvimi (önceden hesaplanmış) çı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ı

AlanTürZorunluNotlar
keysarrayzorunlu

Döndürülecek hesaplamaların adlarını içeren liste. Bu endpoint'in anahtar tablosuna bakın; tanınmayan bir ad varsa isteğin tamamı reddedilir. Kaç anahtar isterseniz isteyin bir çağrı bir kredi tutar; bu yüzden birkaç ayrı çağrı yapmak yerine ihtiyacınız olan her şeyi tek seferde isteyin.

festivalsekadashisjain_festivalssikh_festivalschristian_festivals

Döndürülecek bayram takvimleri. 'festivals' ana Hindu takvimidir; diğerleri ayrı geleneklere aittir. Birkaçını tek çağrıda isteyebilirsiniz - yanıt kategoriye göre anahtarlanır ve ücret değişmez.

yearintegerzorunlu

Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı.

Dört basamaklı yıl. Tarihler 2006 ile 2046 arası için önceden hesaplanmıştır; bu aralığın dışında yanıt boştur.

monthintegeristeğe bağlı

Doğum ayı, 1-12 arası bir sayı olarak. Ocak 1'dir.

İsteğe bağlı, 1-12. Gönderilmezse yılın tamamı döner.

min 1 · max 12

Örnek istek

curl -X POST https://api.occultapi.com/api/festivals/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":9,"keys":["festivals","ekadashis"]}'

Yanıt

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"festivals\": [{\"name\": \"Janmashtami\", \"name_hi\": \"जन्माष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-04T02:26:25+05:30\", \"end_time\": \"2026-09-05T00:14:34+05:30\"}, {\"name\": \"Gugga Navmi\", \"name_hi\": \"गूगा नवमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-05T00:14:34+05:30\", \"end_time\": \"2026-09-05T21:54:40+05:30\"}, {\"name\": \"Vatsa Dvadashi\", \"name_hi\": \"वत्स द्वादशी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-07T17:05:07+05:30\", \"end_time\": \"2026-09-08T14:43:55+05:30\"}, {\"name\": \"Kushotpaatini Ama\", \"name_hi\": \"कुशोत्पाटिनी अमावस्या\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-09T12:31:45+05:30\", \"end_time\": \"2026-09-10T10:34:16+05:30\"}, {\"name\": \"Hartalika Teej\", \"name_hi\": \"हरतालिका तीज\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Varaha Jayanti\", \"name_hi\": \"वराह जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Rishi Tarpana (Samvedic)\", \"name_hi\": \"ऋषि तर्पण (सामवेदिक)\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-13T07:09:27+05:30\", \"end_time\": \"2026-09-14T07:08:00+05:30\"}, {\"name\": \"Siddhi Vinayaka Vrata\", \"name_hi\": \"सिद्धि विनायक व्रत\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-14T07:08:00+05:30\", \"end_time\": \"2026-09-15T07:45:17+05:30\"}, {\"name\": \"Ganesh Chaturthi\", \"name_hi\": \"गणेश चतुर्थी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-14T07:08:00+05:30\", \"end_time\": \"2026-09-15T07:45:17+05:30\"}, {\"name\": \"Rishi Panchami\", \"name_hi\": \"ऋषि पंचमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-15T07:45:17+05:30\", \"end_time\": \"2026-09-16T09:00:28+05:30\"}, {\"name\": \"Balarama Jayanti\", \"name_hi\": \"बलराम जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-16T09:00:28+05:30\", \"end_time\": \"2026-09-17T10:49:00+05:30\"}, {\"name\": \"Radhashtami\", \"name_hi\": \"राधाष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Radha Ashtami\", \"name_hi\": \"राधा अष्टमी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Mahaluxmi Vrata begins\", \"name_hi\": \"महालक्ष्मी व्रत प्रारंभ\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-18T13:02:12+05:30\", \"end_time\": \"2026-09-19T15:28:04+05:30\"}, {\"name\": \"Vishnu Parivartanotsava\", \"name_hi\": \"विष्णु परिवर्तनोत्सव\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-22T21:44:20+05:30\", \"end_time\": \"2026-09-23T22:51:32+05:30\"}, {\"name\": \"Vamana Jayanti\", \"name_hi\": \"वामन जयंती\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-22T21:44:20+05:30\", \"end_time\": \"2026-09-23T22:51:32+05:30\"}, {\"name\": \"Anant Chaturdashi\", \"name_hi\": \"अनंत चतुर्दशी\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-24T23:19:27+05:30\", \"end_time\": \"2026-09-25T23:07:49+05:30\"}, {\"name\": \"Ganesh Visarjan\", \"name_hi\": \"गणेश विसर्जन\", \"month\": \"Bhadrapada\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-24T23:19:27+05:30\", \"end_time\": \"2026-09-25T23:07:49+05:30\"}, {\"name\": \"Pitrupaksha Begins\", \"name_hi\": \"पितृपक्ष प्रारंभ\", \"month\": \"Ashwin\", \"paksha\": null, \"tithi\": null, \"date\": null, \"start_time\": \"2026-09-26T22:19:32+05:30\", \"end_time\": \"2026-09"
}

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.