/api/astro/house/1 krediEv cusp'ları
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.
https://api.occultapi.com/api/astro/house/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ı. 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_systemString 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 sdmorinusBü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 | astrologicaldegreeBü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. |
Örnek istek
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"}'Yanıt
{
"data": {
"set_house_method": null
},
"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.