İçeriğe atla
POST/api/astro/samvatsara/1 kredi

Hindu yılının yöneticileri

Hindu yılının Kralı (King), Bakanı (Minister) ve diğer sekiz yöneticisi. Samvatsaranın başında harita çıkarılır ve izleyen on iki ay için belirli gezegenler belirli görevler üstlenir: Kral yılın bütününü, Bakan yönetimi, diğer yöneticiler de yağışı, serveti, tahılı, özsuları, suyu, meyveyi, ekinleri ve savunmayı yönetir. Almanak yayıncıları yıllık öngörülerini bu çerçeveye göre yazar. Her görev, neyi yönettiğiyle birlikte döner; örneğin `neersesha_of_year` değeri 'Lord of Water, governs rivers and water supply' olarak okunur. Yanıtta ayrıca yılın başladığı an ve samvatsaranın vaahanası yer alır. Doğum haritası gerekmez. Ancak yer önemlidir: her görevin yöneticisi, ilgili olayın düştüğü yerel günün (gün doğumundan gün doğumuna) yöneticisidir; bu yüzden aynı yıl için iki şehirde farklı yöneticiler çıkabilir. `year`, samvatın başladığı Gregoryen yıldır.

https://api.occultapi.com/api/astro/samvatsara/
İ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ı

AlanTürZorunluNotlar
date_timestring (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.

latitudenumber (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

longitudenumber (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

timezone_as_floatnumber (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

yearintegerzorunlu

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

keysarrayisteğe bağlı

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.

nakshatrastringisteğe bağlı

Yalnızca /nakshatra-chakras/ tarafından okunur; diğer yerlerde yok sayılır.

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/samvatsara/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Yanıt

{
  "data": {
    "year": 2025,
    "year_begins": "2025-03-30T06:23:38+05:30",
    "vaahana": "Horse",
    "cabinet": [
      {
        "office": "King (Raja)",
        "key": "king_of_year",
        "governs": "the year as a whole",
        "planet": "Sun"
      },
      {
        "office": "Minister (Mantri)",
        "key": "mantri_of_year",
        "governs": "governance and counsel",
        "planet": "Sun"
      },
      {
        "office": "Lord of Clouds (Meghesha)",
        "key": "meghesha_of_year",
        "governs": "rainfall",
        "planet": "Sun"
      },
      {
        "office": "Lord of Wealth (Dhanesha)",
        "key": "dhanesha_of_year",
        "governs": "money and trade",
        "planet": "Mars"
      },
      {
        "office": "Lord of Grain (Dhaanyesha)",
        "key": "dhaanyesha_of_year",
        "governs": "the grain harvest",
        "planet": "Moon"
      },
      {
        "office": "Lord of Juices (Rasesha)",
        "key": "rasesha_of_year",
        "governs": "sap, juices and liquids",
        "planet": "Venus"
      },
      {
        "office": "Lord of Water (Neeresha)",
        "key": "neersesha_of_year",
        "governs": "rivers and water supply",
        "planet": "Mercury"
      },
      {
        "office": "Lord of Fruit (Phalesha)",
        "key": "phalesha_of_year",
        "governs": "fruit crops",
        "planet": "Saturn"
      },
      {
        "office": "Lord of Crops (Sashyesha)",
        "key": "sashyesha_of_year",
        "governs": "standing crops",
        "planet": "Mercury"
      },
      {
        "office": "Lord of Forts (Durgesha)",
        "key": "durgesha_of_year",
        "governs": "defence and strongholds",
        "planet": "Saturn"
      }
    ],
    "das_adhikari": {
      "King": "Sun",
      "Minister": "Sun",
      "Lord of Clouds": "Sun",
      "Lord of Summer Crops": "Mercury",
      "Lord of Defence": "Saturn",
      "Lord of Treasury": "Mars",
      "Lord of Juicy Products": "Venus",
      "Lord of Food Grains": "Moon",
      "Lord of Metals": "Mercury",
      "Lord of Fruits": "Saturn",
      "Vehicle of Year": "Horse"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.