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

Ev ilişkileri

Bir doğum haritasındaki ilişkiler ağı: hangi burcun hangi burca, hangi gezegenin hangi gezegene açı yaptığı, kimin kimle dost olduğu ve klasik metinlerin haritadaki dönüm noktaları açısından öne çıkardığı gezegenler. Jaimini ve Parashari yorumunun dayandığı mekanizmanın büyük bölümü burada parça parça sunulur. Anahtarlar üç gruba ayrılır. Ev sınıfı anahtarları (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) tamamen geometriktir: her burç için bir satır olmak üzere on iki satırda 1'den 12'ye burç numaraları listelenir ve sonuç haritaya bağlı değildir. Açı ve ilişki anahtarları (`raasi_drishti_of_the_planet`, üç `aspected_*_of_the_planet` anahtarı, iki `*_of_the_raasi` anahtarı, `argala`, `associations_of_the_planet`, üç doğal dostluk anahtarı ve `baadhakas_of_raasi`) haritadaki cisimlerin birbirleriyle ilişkisini anlatır. Jaimini anahtarları (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) ise ömür ve önemli olayların zamanlaması açısından belirleyici gezegenleri verir. Gezegenler her yerde indeks olarak döner: 0 Güneş, 1 Ay, 2 Mars, 3 Merkür, 4 Jüpiter, 5 Venüs, 6 Satürn, 7 Rahu, 8 Ketu. Burçlar, açı ve Jaimini anahtarlarında sıfır tabanlı (0 Koç'tan 11 Balık'a), ev sınıfı anahtarlarında ise bir tabanlıdır (1'den 12'ye); hangisini okuduğunuza dikkat edin. `planet` istek alanı büyük harfle başlar ve büyük/küçük harfe duyarlıdır — 'sun' değil, 'Sun'. `raasi` ise sınır kontrolü yapılmayan, sıfır tabanlı bir tam sayıdır; 0–11 dışındaki bir değer isteğin başarısız olmasına yol açar.

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

BİÇİM kısıtı. 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).

keysarrayzorunlu

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.

trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasi

String dizisi. '_of_the_planet' ile biten anahtarlar ve 'associations_of_the_planet' için `planet`; '_of_the_raasi' ile biten anahtarlar ve 'baadhakas_of_raasi' için `raasi` gerekir.

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

nodestringzorunlu
truemean

Büyük/küçük harfe duyarlı, küçük harfle. 'true' gerçek Ay düğümlerini, 'mean' ortalama düğümleri kullanır. Başka bir değer KeyError -> 400 ile sonuçlanır. Olduğu gibi iletilir.

planetstringzorunlu
SunMoonMarsMercuryJupiterVenusSaturnRahuKetu

Büyük/küçük harfe DUYARLI, baş harfi büyük - /api/astro/chart_analysis/ endpoint'inin kullandığı küçük harfli gök cismi adlarından farklı olduğuna dikkat edin.

raasiintegerzorunlu
01234567891011

String değil, tam sayı. SIFIR TABANLI burç indeksi olarak kullanılır: 0 = Koç ... 11 = Balık. Sınır kontrolü yapılmaz; aralık dışındaki değerler IndexError -> 400 ile sonuçlanır, negatif değerler ise sessizce baştan sarar.

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

Kullanılabilir anahtarlar (29)

İ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.

AnahtarGereken ek alanlarAçıklama
argala—Haritanın tamamı için argala ve virodhargala, iki öğeli bir liste olarak. İlk öğe argaladır, yani bir evin uyguladığı müdahale: yükselenden itibaren her ev için bir satır olmak üzere on iki satır vardır; her satırda o evden sayılan 2., 4., 5. ve 11. evler için dört string bulunur. Evdeki gezegenlerin indeksleri '/' ile birleştirilir; boş evler için boş string yazılır. İkinci öğe virodhargaladır, yani bu müdahaleye karşı engel: 12., 10., 9. ve 3. evler için aynı yapıdadır — bu sırayla alınır, böylece sütunlar argala sütunlarıyla karşılıklı eşleşir.
aspected_houses_of_the_planetplanet`aspected_rasis_of_the_planet` ile aynı graha drishti açıları; ancak burç indeksi olarak değil, yükselenden sayılan 1-12 arası ev numaraları olarak verilir. `planet` gerekir.
aspected_houses_of_the_raasiraasiVerilen burcun rasi drishti ile açı yaptığı evler, yükselenden sayılarak 1'den 12'ye — içlerinde gezegen olsun olmasın hepsi. Sıfır tabanlı burç indeksi olarak `raasi` gerekir.
aspected_planets_of_the_planetplanetVerilen gezegenin graha drishti ile açı yaptığı gezegenler. Graha drishti, Parashari'deki gezegen açısıdır: her gezegen 7. evi görür, Mars, Jüpiter ve Satürn'ün ise ek açıları vardır. Gezegen indekslerinden oluşan bir liste döndürür. `planet` gerekir.
aspected_raasis_of_the_raasiraasi`aspected_houses_of_the_raasi` ile aynı rasi drishti ilişkisi; ancak ev numarası olarak değil, sıfır tabanlı burç indeksleri olarak döner. Bu yüzden yükselenden tamamen bağımsızdır. `raasi` gerekir.
aspected_rasis_of_the_planetplanetVerilen gezegenin graha drishti ile açı yaptığı burçlar; Koç için 0'dan Balık için 11'e sıfır tabanlı burç indekslerinden oluşan bir liste olarak. `aspected_houses_of_the_planet` anahtarının burç karşılığıdır. `planet` gerekir.
associations_of_the_planetplanetVerilen gezegenin, üç klasik bağlantı türünden herhangi biriyle anlamlı biçimde bağlı olduğu tüm gezegenler: aynı burçta bulunmak, graha drishti ile açı yapmak ya da parivartana (karşılıklı burç değişimi) içinde olmak. Tekrarlar ayıklanmış bir gezegen indeksleri listesi döndürür. `planet` gerekir.
baadhakas_of_raasiraasiBelirli bir yükselen burç için baadhaka, yani engelleyici ev ve onu yöneten gezegenler — öncü burçlarda 11., sabit burçlarda 9., değişken burçlarda 7. ev. [sıfır tabanlı baadhaka burcu, onu yöneten gezegenlerin indeks listesi] biçiminde iki öğeli bir liste döndürür. `raasi` gerekir.
brahma—Brahma: Jaimini'nin yaşamın sürmesiyle ilişkilendirdiği gezegen. Yükselen ile yedinci evden hangisi daha güçlüyse, ondan sayılan 6., 8. ve 12. evlerin yöneticilerinden en güçlüsü seçilir. Rahu ve Ketu hesaba katılmaz; eşitlik durumunda asalete, tek burçta bulunmaya ve yarım daire içindeki konuma bakılır. Tek bir gezegen indeksi döndürür.
chara_karakas—Sekiz chara karaka: burç içindeki dereceye göre büyükten küçüğe sıralanmış sekiz gezegen indeksinden oluşan bir liste. İlk öğe Atmakarakadır; diğerleri standart sırayı izler (Amatya, Bhratri, Matri, Pitri, Putra, Gnati, Dara). Ketu hariç tutulur; Rahu ise klasik kural gereği ters çevrilmiş boylamına göre sıralanır.
chathusras—1–12 arası ikişer burç numarasından oluşan on iki satır. Mevcut uygulamada her satır, klasik chatusra çiftini oluşturan 4. ve 8. burçları değil, burçtan sayılan 3. ve 5. burçları verir — 1. satır [3, 5]'tir.
dushthanas—1–12 arası üçer burç numarasından oluşan on iki satır. Mevcut uygulamada her satır burcun kendisini, ondan sayılan 3. ve 7. burçları verir — 1. satır [1, 3, 7]'dir. Bu, klasik 6./8./12. dusthana kümesi değildir; çıktıyı ders kitaplarındaki anlamıyla dusthanalar olarak değil, kodun hesapladığı değer olarak ele alın.
kendras—Her burcun köşe burçları: her burç için bir satır olmak üzere on iki satır; her satır 1'den 12'ye dört burç numarası içeren bir listedir. 0. satır Koç'tur. Parametre almaz. Bu yapı, /api/astro/strength/ endpoint'indeki `kendras` anahtarından farklıdır: o anahtar bir `asc_house` alır ve SIFIR tabanlı dört indeksten oluşan tek bir düz liste döndürür - ikisindeki bir birimlik kaymayı karıştırmak en sık yapılan hatadır.
maheshwara—`maheshwara_from_planet_positions` ile aynı değer — bu anahtar doğrudan onu çağırır ve aynı tek gezegen indeksini döndürür. İkisinden yalnızca birini isteyin.
maheshwara_from_planet_positions—Maheshwara: Jaimini'nin ölümün biçimiyle ilişkilendirdiği gezegen. Atmakarakadan sayılan sekizinci burcun yöneticisi olarak alınır; bu yönetici kendi burcundaysa ya da bir düğümle aynı burçta veya karşıt konumdaysa klasik ikame kuralları uygulanır. Tek bir gezegen indeksi döndürür; sonuç Rahu veya Ketu çıkarsa yerine sırasıyla Merkür veya Jüpiter yazılır.
marakas—`marakas_from_planet_positions` ile aynı maraka gezegenleri; tek fark, haritanın evden gezegene biçiminden hesaplanmasıdır. Sonuç aynı gezegen indeksleri listesidir; bu yüzden ikisini birden değil, yalnızca birini isteyin.
marakas_from_planet_positions—Maraka, yani ölüm getiren gezegenler: 2. ve 7. evlerin yöneticileri ile bu evlerden birinde ya da bu yöneticilerden biriyle aynı yerde bulunan tüm gezegenler. Belirli bir sırası olmayan bir gezegen indeksleri listesi döndürür. Haritanın gezegen konumu biçiminden hesaplanır.
natural_enemies_of_planets—Standart düşmanlık tablosu: 0–8 gezegen indekslerine göre sıralanmış dokuz liste; her liste o gezegene düşman olan gezegenleri verir. Sabittir ve haritaya bağlı değildir; `natural_neutral_of_planets` anahtarının karşılığıdır.
natural_friends_of_planets—Bu haritanın kendi burç yöneticiliklerinden türetilen kalıcı gezegen dostluğu: 0–8 gezegen indeksleriyle anahtarlanmış ve her anahtarda o gezegene dost olan gezegenlerin indeks listesini içeren bir nesne. Yedi klasik gezegen için dost burçların yöneticilerine ek olarak yücelim burcunun yöneticisi de listeye eklenir.
natural_neutral_of_planets—Standart nötrlük tablosu: 0–8 gezegen indekslerine göre sıralanmış dokuz liste; her liste o gezegene nötr olan gezegenleri verir. `natural_friends_of_planets` anahtarından farklı olarak bu, sabit klasik tablodur ve haritaya hiç bağlı değildir.
order_of_planets_by_strength—Dokuz gezegenin tümü en güçlüden başlayarak sıralanmış hâlde, dokuz gezegen indeksinden oluşan bir liste olarak. Sıralama, motorun gezegenleri ikişer ikişer karşılaştıran güç hesabından gelir; Rudra ve Maheshwara hesaplarında aday yöneticiler arasında seçim yaparken kullanılan karşılaştırmanın aynısıdır.
planets_aspecting_the_planetplanetVerilen gezegene graha drishti ile bakan gezegenleri, gezegen indeksleri listesi olarak döndürmesi amaçlanmıştır. Mevcut hâliyle büyük harfle başlayan gezegen adını gezegen indeksi listeleriyle karşılaştırdığı için her girdide boş liste döndürür. Bunun yerine her gezegen için sırayla `aspected_planets_of_the_planet` anahtarını isteyin ve sonucu tersine çevirin.
quadrants—Her burcun köşe burçları: her biri 1–12 arası dört burç numarasından oluşan on iki satır; burcun kendisini ve ondan sayılan 4., 7. ve 10. burçları verir. 1. satır [1, 4, 7, 10]'dur. Bu endpoint'te `kendras` anahtarının takma adıdır — ikisi asla farklı sonuç vermez; ikisini birlikte istemek yanıtta yalnızca gereksiz yer kaplar.
raasi_drishti_of_the_planetplanetVerilen gezegenin bulunduğu burcun rasi drishti ile baktığı burçlardaki gezegenler. Rasi drishti, Jaimini'nin burçtan burca açısıdır: öncü burçlar sabit burçları, sabit burçlar öncü burçları görür; değişken burçlar ise birbirini görür. Gezegen indekslerinden oluşan bir liste döndürür. `planet` gerekir.
rudra—Rudra: yükselenden sayılan sekizinci evin yöneticisi ile yedinci evden sayılan sekizinci evin yöneticisinden daha güçlü olanı. [gezegen indeksi, bulunduğu sıfır tabanlı burç, o burcun sıfır tabanlı üç üçgen burcu] döndürür. Bu anahtarın, iki yöneticiden ikincisini farklı biçimde belirleyen ve bu yüzden farklı bir gezegen döndürebilen `rudra_based_on_planet_positions` anahtarından farklı olduğuna dikkat edin.
rudra_based_on_planet_positions—Rudra: Jaimini'nin haritadaki yıkıcı dönemeçle ilişkilendirdiği gezegen — burada yükselenden sayılan sekizinci burcun yöneticisi ile yedinci evin yöneticisinden daha güçlü olanı. [gezegen indeksi, bulunduğu sıfır tabanlı burç, o burcun sıfır tabanlı üç üçgen burcu] biçiminde üç öğeli bir liste döndürür. `rudra` anahtarından farklı bir yöntemle hesaplanır; ikisi farklı gezegenler gösterebilir.
trikonas—Her burcun üçgen burçları: her biri 1–12 arası üç burç numarasından oluşan on iki satır; burcun kendisini ve ondan sayılan 5. ve 9. burçları verir. 1. satır [1, 5, 9]'dur. Tamamen geometriktir — her harita için aynıdır.
trishoola_rasis—Trishula rasiler: haritanın en zarar verici döneminin zamanlamasında kullanılan, üç burçtan oluşan üç dişli mızrak; Rudra'nın bulunduğu burcun üçgen burçlarıdır. Sıfır tabanlı üç burç indeksi döndürür.
upachayas—1–12 arası dörder burç numarasından oluşan on iki satır. Mevcut uygulamada her satır, klasik upachaya kümesini oluşturan 3., 6., 10. ve 11. burçları değil, burcun kendisini ve ondan sayılan 4., 8. ve 9. burçları verir — 1. satır [1, 4, 8, 9]'dur.

Örnek istek

curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Yanıt

{
  "data": {
    "trikonas": [
      [
        1,
        5,
        9
      ],
      [
        2,
        6,
        10
      ],
      [
        3,
        7,
        11
      ],
      [
        4,
        8,
        12
      ],
      [
        5,
        9,
        1
      ],
      [
        6,
        10,
        2
      ],
      [
        7,
        11,
        3
      ],
      [
        8,
        12,
        4
      ],
      [
        9,
        1,
        5
      ],
      [
        10,
        2,
        6
      ],
      [
        11,
        3,
        7
      ],
      [
        12,
        4,
        8
      ]
    ]
  },
  "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, 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.