curl -X POST https://api.occultapi.com/api/astro/planet_insights/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_sign_insight"],"planet":"Jupiter","sign":"aries","house":0,"nakshatra":"rohini"}'Tek bir konumdaki tek bir gezegen için önceden yazılmış yorumlar. Bir gezegeni ve bulunduğu yeri — bir burç, bir ev ya da bir nakshatra — verin; o birleşimin klasik yorumunu döndürür. Bu bir hesaplama değil, bir metin derleminde aramadır: tarih, saat ya da yer gerekmez ve aynı istek her zaman aynı metni döndürür. Önceden hesapladığınız bir haritaya açıklama metni eklemek için kullanın. Jüpiter'in burcunu, evini ve nakshatrasını `/api/astro/chart/` ile alın, ardından metin için bu endpoint'i çağırın. Üç anahtar tek çağrıda istenebilir, ama her birinin kendi ek parametresi vardır; bu yüzden üçünü birden istediğinizde `planet`, `sign`, `house` ve `nakshatra` alanlarının hepsi gövdede bulunmalıdır. Kapsam: on iki burç ve on iki evde dokuz gezegen (yedi gezegen ile Rahu ve Ketu). Nakshatra yorumları yalnızca yedi klasik gezegen için vardır — Rahu ve Ketu için yoktur. Tanınmayan bir gezegen, burç, ev ya da nakshatra hata döndürmez; HTTP 200 ile açıklayıcı bir string döner. Bu yüzden ekranda göstermeden önce dönen değerin türünü kontrol edin.
| Alan | Tür | Zorunlu | Notlar |
|---|---|---|---|
| house | integer | zorunlu | |
| 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. |
| nakshatra | string | zorunlu | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniYukarıdaki liste jupiter, mercury, venus ve saturn için kullanılan listedir. 'rahu' ve 'ketu' için hiç nakshatra verisi yoktur. Eşleşmeyen değerler HTTP 200 ile "Invalid nakshatra: <x> for planet <p>" döndürür. |
| planet | string | zorunlu | sunmoonmarsmercuryjupitervenussaturnrahuketuBilinmeyen bir gezegen hata durum kodu döndürmez; HTTP 200 ile "Invalid planet: <x>" string'i döner. rahu ve ketu için HİÇ nakshatra verisi olmadığına dikkat edin (insights['rahu']['nakshatras'] None'dır); bu yüzden get_planet_nakshatra_insight "No nakshatra data available for rahu" döndürür. |
| sign | string | zorunlu | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesBelgelenmesi gereken bir VERİ HATASI: planet='sun' için anahtar 'virgo' yerine yanlışlıkla 'vigro' yazılmıştır; bu yüzden sun+virgo "Invalid sign: virgo for planet sun" döndürür, sun+vigro ise çalışır. Diğer sekiz gezegenin tümü 'virgo' kullanır. |
İ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 | |
|---|---|---|---|
| get_planet_house_insight | planet, house | `planet` bir eve yerleştiğinde yapılan yorum; `house` 1 ile 12 arasıdır. Ev etiketini, bir özeti ve özellik listelerini içeren bir nesne döndürür. Ayrıca `classicalTexts` — bu yerleşim hakkında Parashara, Brihat Jataka, Saravali ve Phaladipika'dan alıntılar içeren bir `{heading, text}` listesi — ve `houseLordVariations` — yorumun on iki yükselenin her biri için nasıl değiştiğini veren bir `{ascendent, aspect, result}` listesi — de bulunur. Yalnızca klasik alıntıların bulunduğu yerlerde bazı özet ve özellik alanları null olur. | |
| get_planet_nakshatra_insight | planet, nakshatra | `nakshatra` içindeki `planet` için yorum; yapılandırılmış bir nesne değil, bir iki cümlelik düz metin olarak döner. 27 nakshatranın tümünde yedi klasik gezegen için vardır; Rahu ve Ketu için nakshatra yorumu yoktur, bunun yerine açıklayıcı bir string döner. | |
| get_planet_sign_insight | planet, sign | `sign` içindeki `planet` için yorum. Şunları içeren bir nesne döndürür: `sign` (birleşimin Sanskritçe etiketi, örneğin "Mesa Brhaspati"), bir `summary` paragrafı ve `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` ve `drstiphala` listeleri; sonuncusu, gezegenin o konumdan yaptığı açıların etkilerini kapsar. `core traits` alan adındaki boşluğa dikkat edin. |