curl -X POST https://api.occultapi.com/api/vrat-upavas/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026,"month":9,"keys":["ekadashi","amavasya","pradosham"]}'Vrat ve upavas, Hindu ayında düzenli olarak tekrarlanan, her biri belirli bir tithiye bağlı oruç ve ibadet günleridir. Bu endpoint, istediğiniz türlerin bir yıl boyunca tüm tekrarlarını döndürür. Veriler istek sırasında hesaplanmaz, önceden hesaplanmış bir tablodan okunur; böylece on sekiz dini gün türünü kapsayan bir yıl tek bir indeksli sorguyla gelir. Her tür yalnızca eşleştiği tithi numaralarıyla tanımlanır. Numaralandırma 1-30 şemasına göredir: 1-15 Shukla Pratipada'dan Purnima'ya, 16-29 Krishna Pratipada'dan Chaturdashi'ye kadardır, 30 ise Amavasya'dır. Buna göre `ekadashi` her ayın iki Ekadashi'sini, `pradosham` iki Trayodashi'sini, `shivarathri` her ayın Krishna Chaturdashi'sini (yalnızca Maha Shivaratri değil, aylık Masik Shivaratri), `sashti`, `durgashtami` ve `vinayaka_chathurthi` Shukla yarım ayının altıncı, sekizinci ve dördüncü günlerini, `kaalashtami` ve `sankatahara_chathurthi` bunların Krishna karşılıklarını, `amavasya` ve `pournami` yeni ay ve dolunayları, `sathyanarayana_puja` dolunayı, `chandra_dharshan` ve `moondraam_pirai` büyüyen Ay'ın birinci ve üçüncü günlerini, `srartha_yoga`, `ashtaka`, `manvaadhi` ve `yugadhi` ise kendi küçük tithi kümelerini döndürür. Dikkat: `mahalaya_paksha` 15'ten 30'a kadar her tithiyle eşleşir; yani yalnızca Bhadrapada Pitru Paksha'yı değil, her kameri ayın karanlık yarısının tamamını kapsar. `year` ve `keys` zorunludur. Bunlara ek olarak `latitude`, `longitude` ve `timezone_as_float` gönderirseniz her olaya anlık hesaplanan iki alan eklenir: `moonrise`, yani konumunuzda o olayın tithi aralığına düşen akşam ay doğuşu; ve yalnızca `vinayaka_chathurthi` satırlarında, Madhyahna Ganesha Puja aralığı için `start`, `end` ve `duration_minutes` içeren `puja_muhurat`. Hesaplanamazlarsa ikisi de null döner; koordinatları göndermezseniz hiçbiri yanıtta yer almaz. Yanıt, istenen her türe göre anahtarlanmış `{data}` biçimindedir; her tür `{date, month, tithi, paksha, start_time, end_time}` öğelerinden oluşan kronolojik bir liste içerir. Zamanlar, tithinin başladığı ve bittiği kesin anlardır. Tarihler 2006 ile 2046 (dahil) arasındaki yıllar için önceden hesaplanmıştır; bu aralığın dışındaki bir yıl hata değil, boş liste döndürür.
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| 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. amavasyaashtakachandra_dharshandurgashtamiekadashikaalashtamimahalaya_pakshamanvaadhimoondraam_piraipournamipradoshamsankatahara_chathurthiDöndürülecek dini günler. Birkaçını tek çağrıda isteyebilirsiniz - yanıt türe göre anahtarlanır ve ücret değişmez. |
| year | integer | zorunlu | 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. |
| latitude | number (double) | isteğe bağlı | 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) | isteğe bağlı | 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) | isteğe bağlı | 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. |