/api/astro/muhurat/1 krediTören muhuratları
Bir tarih aralığında, beş Hindu geçiş ayininden birinin yapılabileceği zamanları bulur. Her ayinin izin verilen nakshatralardan oluşan kendi listesi ve tithi, haftanın günü ya da Güneş'in burcuyla ilgili ek koşulları vardır; aralıktaki her örnekleme anı beş ayinin hepsine göre sınanır. Beş ayin şunlardır: mundan (çocuğun ilk saç tıraşı), vidyarambha (eğitime resmen başlama), upanayana (kutsal ip töreni), graha_pravesha (yeni eve taşınma) ve deva_pratishtha (bir tanrı heykelinin yerleştirilmesi). Mundan ayrıca çocuğun yaşını birth_date değerine göre kontrol eder ve yalnızca 1, 3, 5, 7, 10 ve 11 yaşlarına izin verir. start_date, end_date, birth_date, interval_hours ve yer bilgisini gönderin. Tarama aralığı interval_hours adımlarla dolaşır ve uygun her adımı ayrı bir iki saatlik pencere olarak bildirir; bu yüzden uygun bir gün, genellikle birleştirmek isteyeceğiniz birkaç örtüşen satır üretir. Adım küçüldükçe sınırlar incelir, satır sayısı da çok artar. Tarih aralığını birkaç haftayla sınırlı tutun — ücret her durumda bir kredidir, ama her adımda tam bir panchanga yeniden hesaplanır. Tek anahtar: find_muhurats_in_range.
https://api.occultapi.com/api/astro/muhurat/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 |
|---|---|---|---|
| birth_date | string (date-time) | zorunlu | |
| 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. |
| end_date | string (date-time) | zorunlu | |
| interval_hours | integer | zorunlu | |
| 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. |
| 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 -90 · max 90 |
| 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 |
| start_date | string (date-time) | zorunlu | |
| timezone | number (double) | zorunlu | Yerin UTC farkı, saat cinsinden ondalık sayı olarak. Örnek: Hindistan için 5.5 (UTC+05:30). timezone_as_float ile aynı anlama gelir; diğer endpoint'ler aynı alanı farklı bir adla kullanır. min -12 · max 14 |
Kullanılabilir anahtarlar (1)
İ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 |
|---|---|---|
| find_muhurats_in_range | start_date, end_date, birth_date, interval_hours | start_date ile end_date arasını interval_hours adımlarla tarar ve beş törenden birine izin verilen her adımı bildirir. {muhurat, start_time, end_time, nakshatra, tithi} listesi döndürür; muhurat değeri mundan, vidyarambha, upanayana, graha_pravesha veya deva_pratishtha olur. end_time her zaman start_time artı iki saattir; art arda uygun çıkan adımlar birleştirilmez, ayrı ve örtüşen öğeler olarak verilir. Bu yüzden uygun bir gün birkaç satır üretir. |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/muhurat/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["find_muhurats_in_range"],"date_time":"2025-03-27T13:50:05.104Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"start_date":"2025-02-27T13:50:05.104Z","end_date":"2025-03-27T13:50:05.104Z","birth_date":"2025-03-27T13:50:05.104Z","interval_hours":2}'Yanıt
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"find_muhurats_in_range\": [{\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 01:20:05.104000+05:30\", \"end_time\": \"2025-02-28 03:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 03:20:05.104000+05:30\", \"end_time\": \"2025-02-28 05:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 05:20:05.104000+05:30\", \"end_time\": \"2025-02-28 07:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 07:20:05.104000+05:30\", \"end_time\": \"2025-02-28 09:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 09:20:05.104000+05:30\", \"end_time\": \"2025-02-28 11:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 01:20:05.104000+05:30\", \"end_time\": \"2025-03-02 03:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 03:20:05.104000+05:30\", \"end_time\": \"2025-03-02 05:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-06 01:20:05.104000+05:30\", \"end_time\": \"2025-03-06 03:20:05.104000+05:30\", \"nakshatra\": "
}Yukarıdaki isteğin birebir aynısıyla yapılan gerçek bir çağrıdan alındı. Sonuçlar data altında, istediğiniz her anahtarın adıyla 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.