Playground yükleniyor
curl -X POST https://api.occultapi.com/api/astro/festival/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["calculate_festivals"],"moon_option":"amavas","year":2025,"date_time":"2025-02-12T08:35:00.795Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Bir takvim yılındaki tüm Hindu bayramları, verdiğiniz yer için baştan hesaplanır; motorun izlediği ekadashi'ler ile Jain, Sih ve Hristiyan dini günleri de buna dahildir. Her gelenek için derlenmiş bir liste döndüren bölgesel takvim endpoint'lerinden farklı olarak bu, Hindistan genelindeki bayramların tamamıdır ve her öğede kesin tithi aralığı yer alır. Yıl, gün gün değil tithi tithi taranır; böylece yirmi dört saatten kısa bir tithi gözden kaçmaz, uzun bir tithi de iki kez sayılmaz. `moon_option` kameri ayların nasıl adlandırılacağını belirler: 'poornima' purnimanta ayını doğrudan kullanır; 'amavas' dahil diğer her değer amanta ayını alıp dönüştürür — Kuzey Hint panchanglarının çoğunda basılan da budur. `year`, `date_time` ve yer bilgisini gönderin. Her öğe tek bir tarih yerine belirleyici tithinin başlangıç ve bitişini içerdiğinden, hangi takvim gününde gösterileceğine siz karar verirsiniz. Bu kararı sizin yerinize vermesini istiyorsanız, her dini günü fiilen kutlandığı güne yerleştiren bölgesel takvim endpoint'lerinden birini kullanın.
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| date_time | string (date-time) | zorunlu | Hesaplamanın yapılacağı an, ISO 8601 biçiminde. Değere HER ZAMAN bir saat farkı ya da sonda Z ekleyin - saat dilimi içermeyen bir değer UTC değil, Asia/Kolkata (UTC+05:30) olarak okunur ve 200 koduyla bir önceki günün sonucunu döndürebilir. '2026-09-01T06:00:00Z' ile '2026-09-01 06:00:00' farklı anlardır ve farklı sonuç verir. BİÇİM kısıtı. DRF DateTimeField: yalnızca ISO-8601 (DRF varsayılan giriş biçimleri), ör. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" veya "2026-09-01 06:00:00" (saat dilimi yoksa UTC varsayılır). |
| keys | array | zorunlu | 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. calculate_festivalsString dizisi; tek bir anahtar vardır. |
| 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. min -89.9 · max 89.9 |
| 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. min -180 · max 180 |
| moon_option | string | zorunlu | amavaspoornimaBüyük/küçük harfe duyarlı, küçük harfle. 'poornima' purnimanta kameri ayını doğrudan kullanır; DİĞER HER değer - 'amavas' değerinin kendisi ve her türlü yazım hatası dahil - else dalına düşer (amanta ayı purnimantaya dönüştürülür); bu yüzden yazım hataları sessizce 'amavas' gibi davranır. Olduğu gibi iletilir. |
| 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. min -12 · max 14 |
| year | integer | zorunlu | Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı. |
İstediğiniz hesaplamaları keys içinde tek tek sayın; yalnızca onlar hesaplanır. Bilinmeyen tek bir anahtar bile isteğin tamamını reddettirir. Kaç anahtar isterseniz isteyin ücret 1 kredi olur; bu yüzden hepsini tek istekte toplayın.
| Anahtar | Gereken ek alanlar | Açıklama | |
|---|---|---|---|
| calculate_festivals | year | Yılın tüm dini günleri, beş liste içeren bir nesne olarak: `festivals`, `ekadashis`, `jain_festivals`, `sikh_festivals` ve `christian_festivals`. Her öğede bayramın adı, belirleyici tithinin UTC zaman damgası string'i olarak `start` ve `end` değerleri ve kameri ay (`month`) bulunur; ekadashi öğelerinde ayrıca `paksha` da yer alır. `year` alır. |