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

Gezegen yerleşimi yorumları

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.

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

nakshatrastringzorunlu
ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguni

Yukarı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.

planetstringzorunlu
sunmoonmarsmercuryjupitervenussaturnrahuketu

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

signstringzorunlu
ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspisces

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

Kullanılabilir anahtarlar (3)

İ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
get_planet_house_insightplanet, 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_insightplanet, 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_insightplanet, 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.

Örnek istek

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"}'

Yanıt

{
  "data": {
    "get_planet_sign_insight": {
      "sign": "Mesa Brhaspati",
      "summary": "Jupiter in Aries produces a bold, authoritative, and resourceful individual with strong leadership capabilities. Aries is ruled by Mars (Maṅgala), a planet friendly to Jupiter and symbolizing courage, initiative, and battle-readiness. Jupiter here gains the spirit of a warrior-sage, combining spiritual strength with physical initiative. The placement enhances fame, wealth, power, and generational prosperity, especially through sons. However, the position also introduces difficulties like enemies, physical injuries, and excessive expenditures due to Aries being the debilitation sign for Saturn (Śani), whose tamasic qualities interfere with Jupiter's sattvic nature. The individual is splendorous, generous, and powerful, but also faces trials that temper their greatness",
      "core traits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments"
      ],
      "psychologicalPhysicalTraits": [
        "Argumentative in disposition",
        "Acquiring precious stones and ornaments through effort",
        "Endowed with strength, sons, and wealth",
        "Eminent and famous profession",
        "Splendorous",
        "Many enemies",
        "Many expenses",
        "Injured body",
        "Confers severe and cruel punishments",
        "Love of grandeur",
        "Powerful",
        "Wealthy",
        "Prudent",
        "Many children",
        "Courteous",
        "Generous",
        "Firm",
        "Sympathetic",
        "Happy marriage",
        "Patient nature",
        "Harmonious",
        "Refined",
        "High position"
      ],
      "astrologicalReasoning": [
        {
          "heading": "Initiative & Argumentation",
          "text": "Meṣa is ruled by Maṅgala, the god of war and action, endowing Jupiter with a strong fighting disposition and argumentative temperament."
        },
        {
          "heading": "Wealth & Luxuries",
          "text": "Sūrya, exalted in Meṣa, governs precious metals and gemstones. Jupiter, the Dhanakāraka, placed here results in acquiring valuables through effort."
        },
        {
          "heading": "Progeny & Strength",
          "text": "Meṣa is a masculine sign ruled by male planets (Sūrya and Maṅgala). Jupiter, as the Santana Kāraka, gains support here, indicating sons, strength, and vitality."
        },
        {
          "heading": "Fame & Eminence",
          "text": "As the 1st house of Kālapuruṣa, Aries governs fame. Jupiter's placement brings name, professional eminence, and public recognition."
        },
        {
          "heading": "Drawbacks of the Sign",
          "text": "Meṣa is Śani's debilitation sign. Jupiter here absorbs Śani's weaknesses, causing a rise in enemies (6H), injury-proneness, emotional detachment (due to 8H being Moon's debilitation), and heavy expenditure (12H effects)."
        },
        {
          "heading": "Judgement & Harshness",
          "text": "With Jupiter reflecting Maṅgala's and Śani's stern traits, the native may confer harsh or severe judgments lacking emotional nuance."
        }
      ],
      "drstiphala": [
        {
          "planet": "Sūrya",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Candra",
          "aspect": "positive",
          "result": "Charitable, truthful, famous sons, highly fortunate, abundant hair on the body."
        },
        {
          "planet": "Maṅgala",
          "aspect": "positive",
          "result": "Belonging to a royal dynasty, fearless, fierce, endowed with political knowledge, modest, affluent, has a disobedient wife and disobedient servants."
        },
        {
          "planet": "Budha",
          "aspect": "negative",
          "result": "Liar, crafty, sinful, skilful in detecting others' flaws, serves others, grateful, modest, not outspoken."
        },
        {
          "planet": "Śukra",
          "aspect": "positive",
          "result": "Very happy with residences, sleeping comforts, robes, perfumes, garlands, ornaments, wife, very timid."
        },
        {
          "planet": "Śani",
          "aspect": "mixed",
          "result": "Talkative, eloquent, devoid of happiness, brilliant, has mean children and a mean wife."
        }
      ]
    }
  },
  "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.