POST/api/astro/traditional/profections/1 kredi

Profeksiyonlar

Yıllık, aylık ve günlük profeksiyonlar ve her dönemin yöneticisi. Helenistik astrolojinin başlıca ve en basit zamanlama tekniğidir: harita, yükselenden başlayarak yaşamın her yılı için bir tam burç ilerler. Bu yüzden 33 yaşındaki biri 10. ev profeksiyonundadır ve o burcun yöneticisi Yılın Yöneticisi olur; yıl bu gezegen üzerinden yorumlanır. Aynı hareket yıl içinde daha hızlı tekrarlanır: ayda bir burç ve yaklaşık iki buçuk günde bir burç. Üçü de her dönemin kesin başlangıç ve bitişiyle birlikte döner, çünkü bir yorumda genellikle tema için yıllık, zamanlama için aylık profeksiyon kullanılır. Aylık profeksiyon yükselenden yeniden başlamaz, yıllık burçtan devam eder; günlük profeksiyon da aylıktan devam eder. Yaş, geçen gün sayısı bölünerek değil, DOĞUM GÜNÜNE göre hesaplanır: profeksiyon Güneş dönüşünde değişir; bu yüzden otuz üçüncü doğum gününden on bir ay sonra bir kişi hâlâ otuz dördüncü yaşındadır. Çoğu uygulama bu ayrıntıyı yanlış yapar. Tüm zaman damgaları UTC'dir; böylece dönemler yeniden ayrıştırılmadan karşılaştırılıp sıralanabilir.

https://api.occultapi.com/api/astro/traditional/profections/

İ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.
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
as_of	string (date-time)	isteğe bağlı	Profeksiyonun hesaplanacağı tarih. Varsayılan: şu an (UTC).
house_system	string	isteğe bağlı	Profeksiyonlar geleneksel olarak tam burç (whole-sign) sistemiyle yapılır; bu seçenek yine de burada, çünkü yalnızca yükselen BURÇ kullanılır. `campanusequalkochplacidusporphyryregiomontanustopocentricwhole_sign`
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/profections/ \
  -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,"as_of":"2026-09-09T12:00:00+00:00"}'

Yanıt

{
  "data": {
    "zodiac": "tropical",
    "as_of": "2026-09-09T12:00:00+00:00",
    "age": 36,
    "ascendant": {
      "degree": 201.479077,
      "sign": "Libra",
      "sign_index": 7,
      "degree_in_sign": 21.4791,
      "formatted": "21°28' Libra"
    },
    "annual": {
      "period": "year",
      "house": 1,
      "sign": "Libra",
      "sign_index": 7,
      "lord": "venus",
      "lord_position": {
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 1.573,
        "formatted": "1°34' Leo",
        "retrograde": false
      },
      "from": "2026-08-15T05:00:00+00:00",
      "to": "2027-08-15T05:00:00+00:00"
    },
    "monthly": {
      "period": "month",
      "house": 1,
      "sign": "Libra",
      "sign_index": 7,
      "lord": "venus",
      "lord_position": {
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 1.573,
        "formatted": "1°34' Leo",
        "retrograde": false
      },
      "from": "2026-08-15T05:00:00+00:00",
      "to": "2026-09-14T15:00:00+00:00"
    },
    "daily": {
      "period": "day",
      "house": 10,
      "sign": "Cancer",
      "sign_index": 4,
      "lord": "moon",
      "lord_position": {
        "sign": "Gemini",
        "sign_index": 3,
        "degree_in_sign": 12.66,
        "formatted": "12°39' Gemini",
        "retrograde": false
      },
      "from": "2026-09-07T00:30:00+00:00",
      "to": "2026-09-09T13:20:00+00:00"
    },
    "lord_of_the_year": "venus",
    "note": "Age is counted by birthday, so the annual profection turns over on the solar return rather than on 1 January or on a 365-day division of elapsed time."
  },
  "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.