/api/astro/traditional/almuten/1 krediAlmuten
Harita genelinde ve haritanın her önemli noktasında en çok asalete sahip gezegen. Geleneksel astroloji yalnızca gezegenlerin nerede olduğunu değil, belirli bir derecede hangisinin en güçlü olduğunu da sorar. Almuten bu sorunun yanıtıdır: o derecede ağırlıklı asalet puanı en yüksek olan gezegen. Sonuç üç biçimde döner. `by_point`, Güneş, Ay, yükselen, MC ve Şans Noktası için almuteni verir; farkı görebilmeniz için her adayın puanı da yer alır. `by_planet`, her gezegenin bu noktaların tümündeki toplam puanını verir. `almuten_figuris` ise genel kazanandır, yani ortaçağ şemasında haritanın yöneticisi. Yalnızca asaletler sayılır, zaaflar sayılmaz: almuten bir dereceyi kimin yönettiğini sorar, orada kimin zayıf olduğunu değil; bu yüzden hiçbir puan negatif olmaz. Şans Noktası sekte göre tersine döner: gündüz yükselen + Ay − Güneş, gece bunun tersi. Çoğu uygulama bu adımı atlar. Eşitlikler eşitlik olarak bildirilir. İki gezegen eşit puan aldığında `tied` bu gezegenleri listeler ve almuten null olur, çünkü eşitliği sessizce bozmak, bir görüşü hesaplama gibi sunmak olurdu.
https://api.occultapi.com/api/astro/traditional/almuten/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. |
| 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 -89.9 · max 89.9 |
| 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 |
| 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. min -12 · max 14 |
| keys | array | isteğ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. |
Örnek istek
curl -X POST https://api.occultapi.com/api/astro/traditional/almuten/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Yanıt
{
"data": {
"zodiac": "tropical",
"sect": {
"sect": "diurnal",
"is_day_chart": true,
"sun_altitude": 58.950403,
"light": "sun",
"benefic": "jupiter",
"malefic": "saturn",
"contrary_malefic": "mars",
"contrary_benefic": "venus"
},
"points": {
"sun": 142.125,
"moon": 72.66,
"ascendant": 201.479077,
"midheaven": 112.347516,
"part_of_fortune": 132.014077
},
"by_point": {
"sun": {
"degree": 142.125,
"sign": "Leo",
"sign_index": 5,
"degree_in_sign": 22.125,
"formatted": "22°07' Leo",
"scores": {
"sun": 8,
"moon": 0,
"mercury": 2,
"venus": 0,
"mars": 1,
"jupiter": 0,
"saturn": 0
},
"almuten": "sun",
"tied": []
},
"moon": {
"degree": 72.66,
"sign": "Gemini",
"sign_index": 3,
"degree_in_sign": 12.66,
"formatted": "12°39' Gemini",
"scores": {
"sun": 0,
"moon": 0,
"mercury": 5,
"venus": 2,
"mars": 1,
"jupiter": 0,
"saturn": 3
},
"almuten": "mercury",
"tied": []
},
"ascendant": {
"degree": 201.479077,
"sign": "Libra",
"sign_index": 7,
"degree_in_sign": 21.4791,
"formatted": "21°28' Libra",
"scores": {
"sun": 0,
"moon": 0,
"mercury": 0,
"venus": 7,
"mars": 0,
"jupiter": 1,
"saturn": 7
},
"almuten": null,
"tied": [
"saturn",
"venus"
]
},
"midheaven": {
"degree": 112.347516,
"sign": "Cancer",
"sign_index": 4,
"degree_in_sign": 22.3475,
"formatted": "22°20' Cancer",
"scores": {
"sun": 0,
"moon": 6,
"mercury": 0,
"venus": 3,
"mars": 0,
"jupiter": 6,
"saturn": 0
},
"almuten": null,
"tied": [
"jupiter",
"moon"
]
},
"part_of_fortune": {
"degree": 132.014077,
"sign": "Leo",
"sign_index": 5,
"degree_in_sign": 12.0141,
"formatted": "12°00' Leo",
"scores": {
"sun": 8,
"moon": 0,
"mercury": 0,
"venus": 0,
"mars": 0,
"jupiter": 1,
"saturn": 2
},
"almuten": "sun",
"tied": []
}
},
"by_planet": {
"sun": 16,
"moon": 6,
"mercury": 7,
"venus": 12,
"mars": 2,
"jupiter": 8,
"saturn": 12
},
"almuten_figuris": "sun",
"tied": [],
"note": "The prenatal syzygy, a fifth hylegiacal point in some sources, is not included; the midheaven is used in its place. Ties are reported rather than broken."
},
"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.