POSThttps://api.occultapi.com/api/astro/house/

Ev cusp'ları

İstek gövdesiJSON

Göndermek için yukarıya bir API anahtarı yapıştırın.

Kod örneği

curl -X POST https://api.occultapi.com/api/astro/house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["set_house_method"],"latitude":26.9124,"longitude":26.1046,"timezone_as_float":5.5,"method_name":"equal","notation":"astrological","date_time":"2024-11-18"}'

Belirli bir an ve yer için, seçtiğiniz ev sistemine göre on iki ev bölümü. Vedik uygulamada genellikle her burç bir ev sayılır, ancak bu endpoint efemerisin sunduğu tüm sistemleri açar — yirmi dört kadar sistem arasında Placidus, Koch, Campanus, Regiomontanus, Sripati, Porphyry, eşit ev ve tam burç da vardır — böylece aynı haritayı belirli bir geleneğin beklediği sistemle çıkarabilirsiniz. Konumlar sideraldir. Doğru anlaşılması gereken ayrım, cusp ile aralık arasındaki farktır. Cusp, sistemin bir eve atadığı tek derecedir; aralık ise evin gerçekte kapladığı alandır ve burada komşu cusp'ların orta noktaları olarak hesaplanır. Yani bir ev, önceki cusp'a olan mesafenin yarısından başlar ve sonraki cusp'a olan mesafenin yarısında biter. `house_cusps` on iki cusp'ı, `house_starts` ve `house_ends` iki kenarı ayrı ayrı, `house_ranges` iki kenarı birlikte, `houses` ise üçünü birden verir. `notation` tüm yanıttaki birimleri belirler: ekliptik boyunca ham ondalık derece için 'degree', burç artı derece, dakika ve saniye için 'astrological'. `method_name` büyük/küçük harfe duyarlıdır ve bazı değerler boşluk ya da noktalama işareti içerir; bu yüzden değerleri birebir kopyalayın. Sistem istek oluşturulurken `method_name` değerine göre zaten uygulanır; bu yüzden `set_house_method` ve `change_house_system` yalnızca çok anahtarlı bir çağrının ortasında sistem değiştirmek için işe yarar.

İ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ı. 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).
keys	array	zorunlu	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. `set_house_methodhouseshouse_rangeshouse_startshouse_cuspshouse_endschange_house_system` String dizisi. 'set_house_method' ve 'change_house_system' `method_name` değerini, diğer beşi `notation` değerini kullanır.
method_name	string	zorunlu	`equalalcabitiuscampanusequal (mc)carter poli-equ.gauquelin sectorshorizon/azimutsunshinesavard-akochpullen sdmorinus` Büyük/küçük harfe duyarlı, küçük harfle. Bazı değerler boşluk, eğik çizgi ya da noktalama işareti içerir - bunları birebir kopyalayın, ör. 'equal (mc)', 'carter poli-equ.', 'horizon/azimut'.
notation	string	zorunlu	`astrologicaldegree` Büyük/küçük harfe duyarlı, küçük harfle. 'degree' ham ondalık dereceyi, 'astrological' burç + d/m/s döndürür. Başka bir değer 400 döndürür.
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
latitude	number (double)	isteğe bağlı	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)	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

Kullanılabilir anahtarlar (7)

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

Anahtar	Gereken ek alanlar	Açıklama
change_house_system	method_name	`set_house_method` ile aynı işlemi yapar: `method_name` alanında belirtilen sisteme geçer ve null döndürür. İki anahtar da aynı kodu çağırır; aralarında hiçbir fark yoktur.
house_cusps	notation	Seçilen ev sisteminin tanımladığı on iki ev cusp'ı, ev sırasına göre düz bir liste olarak. Bunlar ev sınırları değil, cusp derecelerinin kendisidir — sınırlar `house_starts` ve `house_ends` içindedir ve art arda gelen iki cusp'ın tam ortasında yer alır.
house_ends	notation	Yalnızca her evin bitiş kenarı; ev sırasına göre on iki değerden oluşan düz bir liste olarak. Her değer, o evin cusp'ı ile bir sonraki evin cusp'ı arasındaki orta noktadır; bu yüzden n. evin sonu, n+1. evin başlangıcına eşittir.
house_ranges	notation	Her evin kapladığı aralık: '1' ile '12' arasında anahtarlanmış ve her ev için `start` ve `end` içeren bir nesne. Kenarlar komşu cusp'ların orta noktalarıdır; yani bir ev, önceki cusp'a olan mesafenin yarısında başlar ve sonraki cusp'a olan mesafenin yarısında biter. 'degree' gösteriminde değerler ondalık derecedir; 'astrological' gösteriminde burç, derece, dakika ve saniyeden oluşan nesnelerdir.
house_starts	notation	Yalnızca her evin başlangıç kenarı; ev sırasına göre on iki değerden oluşan düz bir liste olarak — `house_ranges`'in döndürdüğü gibi ev numarasıyla anahtarlanmış bir nesne değil. 'degree' gösteriminde ondalık derece, 'astrological' gösteriminde burç ve d/m/s nesneleri döner.
houses	notation	`1` ile `12` arasında anahtarlanmış on iki ev; her biri `{start, cusp, end}` biçimindedir - iki sınır ve aralarındaki cusp. Bu yapının, `{start, mid, end}` döndüren ve cusp içermeyen /api/astro/krishnamurti/ endpoint'indeki `houses` anahtarından farklı olduğuna dikkat edin. Birimleri `notation` belirler: `degree` ondalıklı sayılar, `astrological` ise `"Aries 12 30 15"` gibi string'ler verir.
set_house_method	method_name	Cusp'ları `method_name` alanında belirtilen ev sistemine göre yeniden hesaplar. Değer değil, mod değiştiricidir — null döndürür ve yalnızca dizide kendisinden sonra gelen anahtarları etkiler. Sistem istek oluşturulurken `method_name` değerine göre zaten uygulandığından, çağrının ortasında sistem değiştirmiyorsanız bu anahtara gerek yoktur.

Bu endpoint'in tam referansı