POST/api/astro/attributes/1 kredi

Harita öznitelikleri

On iki küçük harita değerini tek çağrıda döndüren bir derleme — normalde bir düzine ayrı istekle alacağınız türden bilgiler. Ne gönderirseniz gönderin on ikisini de her zaman hesaplar. Kapsananlar şunlardır: belirli bir ekliptik boylamın nakshatrası ve padası, adı verilen bir nakshatranın numarası ve yönetici gezegeni, bir burç içindeki boylamın Hadda (Mısır sınırı) yöneticisi, Kakshya yöneticisi ve Kakshya numarası, bir boylamın düştüğü zodyak burcu, verilen anda hangi gezegenlerin yanık olduğu, Ay'ın evre açısı, seçilen bir Ay evresinin bir sonraki gerçekleşme anı, bir yılın dört mevsim başlangıcı ve bir boylamdan türetilen varga haritası konumu. Yalnızca `date_time` zorunludur; diğer her şey varsayılan bir değere geri döner (boylam 0, ad 'Ashwini', zodyak 'Aries', yönetici 'saturn', yeni ay için target_phase 0, limitdays 30, içinde bulunulan yıl, Rashi haritası için chart_factor 1). Bu yüzden yalnızca `date_time` ve `longitude` içeren en basit çağrı bile yanık gezegenleri, Ay evresini, nakshatrayı ve burcu verir. İki tuhaflık var: `lord`, Merkür'ü baş harfi büyük olarak saklayan veriyle büyük/küçük harfe duyarlı biçimde eşleştirilir; bu yüzden 'mercury' sessizce null döndürürken 'Mercury' bir sayı döndürür. Ayrıca `when` ve `nakshatras` istek alanları kabul edilir ama hiç okunmaz.

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

İ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
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ı, enum değil. 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).
chart_factor	integer	isteğe bağlı	dasavarga_from_longitude için varga haritası çarpanı (1=Rashi, 9=Navamsa vb.).
limitdays	integer	isteğe bağlı	search_moon_phase için gün cinsinden arama aralığı.
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. min -180 · max 180
lord	string	isteğe bağlı	get_kakshya_number'ın kullandığı yönetici gezegen. `saturnjupitermarssunvenusMercurymoonascendant` Büyük/küçük harfe DUYARLI tam eşleşme. Verinin kendisi tutarsızdır: yedi kayıt küçük harfle yazılmıştır ama Merkür baş harfi büyük olarak 'Mercury' biçiminde saklanır; bu yüzden 'mercury' sessizce null döndürürken 'Mercury' 6 döndürür. Eşleşmeyen bir değer hata vermeden null döndürür. Varsayılan: 'saturn'.
nakshatras	string	isteğe bağlı
name	string	isteğe bağlı	get_nakshatra_details'in kullandığı nakshatra adı. `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` `nakshatra_details` sonucunu belirleyen nakshatra adı. Büyük/küçük harfe duyarsızdır; baştaki ve sondaki boşluklar kırpılır. Hem modern yazımlar (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) hem de motorun eski transliterasyonları (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra) tanınır. 'Abhijit' de kabul edilir (28 nakshatralı şema). Varsayılan: 'Ashwini'.
target_phase	integer	isteğe bağlı	Aranacak Ay evresi: 0=yeni ay, 1=ilk dördün, 2=dolunay, 3=son dördün.
when	string	isteğe bağlı
year	integer	isteğe bağlı	Doğum yılı, sayı olarak; ör. 1990. Dört basamaklı.
zodiac	string	isteğe bağlı	get_hadda_lord'un kullandığı zodyak burcu. `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/attributes/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'

Yanıt

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "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.