POST/api/astro/lunar_month_scan/1 kredi

Kameri ay taraması

Adı verilen bir Hindu kameri ayının — Chaitra, Vaisakha, Jyeshtha vb. — bir takvim yılı içindeki kesin başlangıç ve bitiş anlarını bulur. Gregoryen aya değil, kameri aya bağlı her türlü planlama için kullanışlıdır. Ay sınırlarının nereye düşeceğini reckoning belirler. 'amanta' ile (varsayılan; güneyde ve batıda kullanılır) bir ay bir yeni aydan ötekine sürer ve adını, başlangıçtaki yeni ay anında Ay'ın bulunduğu burçtan alır. 'poornima' ile bir dolunaydan ötekine sürer ve adını, başlangıçtaki dolunay anında Güneş'in bulunduğu burçtan alır; kuzey takvimleri bunu kullanır. Karanlık yarım ayda iki yöntem aynı günü farklı adlı aylara yerleştirir. month_name, year ve timezone_as_float gönderin; yer bilgisi gerekmez. Yanıt {year, month_name, reckoning, rows} biçimindedir; rows, UTC cinsinden {start, end} zaman damgalarından oluşan bir listedir — genellikle tek öğe içerir, aynı adlı bir adhika (artık) ay da o yıla düşerse iki öğe olur. Tarama, ikisinden hangisinin artık ay olduğunu belirtmez.

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

İsteği deneyin

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
month_name	string	zorunlu	`VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra`
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
reckoning	string	isteğe bağlı	`amantapoornima`

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/lunar_month_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month_name":"Vaisakha","timezone_as_float":5.5,"year":2026,"reckoning":"amanta"}'

Yanıt

{
  "data": {
    "year": 2026,
    "month_name": "Vaisakha",
    "reckoning": "amanta",
    "rows": [
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-05-16T20:01:32+00:00"
      }
    ]
  },
  "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.