Direkt zum Inhalt
POST/api/astro/house_information/1 Credit

Bedeutungen der Häuser

Jedes Haus eines Horoskops – jedes der zwölf Bhavas – steht für eine Gruppe von Lebensbereichen: das 4. Haus für Heim und Mutter, das 7. für Partnerschaft, das 10. für den Beruf. Dieser Endpoint liefert das Referenzblatt zu einem Haus: wofür es steht, sein Element und seine Qualität, seine Themen nach Überschriften gruppiert und wie man es über den Hausherrscher, die Planeten darin und seine natürlichen Signifikatoren beurteilt. Das ist reines Nachschlagen, keine Berechnung. Du übergibst house_number von 1 bis 12 und erhältst jedes Mal denselben Text – Geburtsdatum, Uhrzeit und Ort spielen keine Rolle. Damit kannst du ein anderswo berechnetes Horoskop beschriften oder ein Erklärfeld daneben füllen. Der einzige Key ist get_house_info. Eine Zahl außerhalb von 1-12 löst keinen Fehler aus, sondern liefert den String 'Invalid house number' mit HTTP 200.

https://api.occultapi.com/api/astro/house_information/
Anfrage testen

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

FeldTypPflichtHinweise
house_numberintegerPflicht
123456789101112
keysarrayPflicht

Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen.

get_house_info

Array von Strings; es gibt nur einen Key. HINWEIS: Die Konfigurationsdatei heißt 'house_informations' (Plural), die Route dagegen /api/astro/house_information/.

Verfügbare Keys (1)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

KeyZusätzliche FelderBeschreibung
get_house_infohouse_numberAlle Bedeutungen eines Bhava, ausgewählt über house_number 1-12. Liefert ein Objekt mit 'other names' (der Sanskrit-Name, z. B. Sukha Bhava), 'element & quality', einer Beschreibung als Fließtext in 'description', 'keywords & significations' – einem Dictionary thematischer Gruppen mit jeweils einer Liste von Stichworten – und 'astrological info' mit vier Hinweisen: zum Hausherrscher, zu den Planeten im Haus, zu den natürlichen Signifikatoren und einer allgemeinen Regel zur Beurteilung. Statischer Referenztext, bei jeder Anfrage identisch.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/house_information/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_house_info"],"house_number":4}'

Antwort

{
  "data": {
    "get_house_info": {
      "other names": "Sukha Bhava",
      "element & quality": "Movable, Water",
      "description": "The 4th house represents comfort, emotional happiness, and inner peace. It is deeply tied to one's home, mother, vehicles, land, and personal well-being. It is also connected to learning, cultural roots, and sacred knowledge. As the house of shelter, nurturing, and support, it governs the environments that provide safety and emotional grounding.",
      "keywords & significations": {
        "Comfort & Happiness": [
          "emotional peace",
          "joy",
          "contentment",
          "domestic bliss",
          "the source of one's sense of well-being"
        ],
        "Mother & Maternal Side": [
          "mother",
          "maternal relatives",
          "relationship with maternal lineage"
        ],
        "Home & Property": [
          "house",
          "real estate",
          "property matters",
          "living space",
          "entering a new home",
          "ancestral property",
          "loss of residence"
        ],
        "Conveyance & Travel": [
          "vehicles (rickshaws, boats, etc.)",
          "means of transportation",
          "local travel"
        ],
        "Land & Agriculture": [
          "land",
          "agriculture",
          "fertile fields",
          "gardens",
          "ponds and wells (including construction)",
          "land arising from islands or wet zones",
          "grain from wetlands"
        ],
        "Learning & Intellect": [
          "learning",
          "sacred texts",
          "wise counsel",
          "pure intellect"
        ],
        "Physical Comforts": [
          "perfumes",
          "clothing",
          "ornaments",
          "oil baths",
          "water and drinks",
          "celestial foods"
        ],
        "Cultural & Spiritual Values": [
          "castes",
          "rites",
          "religion-based education",
          "victory in personal efforts",
          "divine remedies"
        ],
        "Family & Relations": [
          "relatives",
          "well-wishers",
          "father",
          "wife",
          "friends",
          "children of siblings"
        ],
        "Security & Wealth": [
          "securing of savings",
          "stable financial base",
          "result or conclusion of efforts"
        ],
        "Animals & Livelihood": [
          "cattle (cows, buffaloes)",
          "horses",
          "elephants",
          "domestic animals for livelihood"
        ],
        "Creative & Domestic Arts": [
          "architecture",
          "art",
          "house-building skills",
          "pavilions",
          "layout and use of spaces"
        ],
        "Challenges": [
          "false accusations",
          "loss of home",
          "tiring or exhausting work"
        ],
        "Unique Aspects": [
          "trust",
          "noble reputation",
          "guidance in locating lost or hidden items",
          "anthills"
        ]
      },
      "astrological info": {
        "4th Lord (4L)": "Plays a pivotal role in determining sources of emotional comfort and security. Its placement, dignity, and the Bhava it occupies are key",
        "Planets in 4H": "Influence the nature of one's peace and comforts. When placed in their own, exalted, or friendly signs, they enhance well-being. If debilitated or afflicted by challenging combinations, the associated areas may become sources of discomfort",
        "Karaka Planets": "Moon – for mother and emotional nourishment; Venus – for conveyances, comforts, and pleasures; Mars – for land and property",
        "General Rule": "Strong, benefic influences on the 4th house and its lord lead to happiness, prosperity at home, and mental tranquility. Affliction or weakness indicates emotional disturbances or issues related to home and domestic life"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.