POST/api/astro/house_lord_particular_house/1 Credit

Platzierung eines Hausherrschers (ein Paar)

Der Herrscher eines Hauses nimmt die Themen dieses Hauses überallhin mit. Deshalb kennen die Klassiker für jede der 144 Kombinationen – zwölf Herrscher an zwölf Stellen – eine eigene Aussage. Dieser Endpoint liefert die Aussage für ein Paar. Gib in house das Haus an, dessen Herrscher du meinst, mit den Sanskrit-Bhava-Namen dieses Endpoints – lagna, dhana, sahaja, sukha, putra, satru, yuvati, randhara, dharma, karma, labha, vyaya für das 1. bis 12. Haus –, und in number das Haus, in dem er steht, von 1 bis 12. Beachte: /api/astro/effect_house_lord_different_house/ behandelt dasselbe Thema mit anderen Namen und anderem Text; die beiden sind nicht austauschbar. Es wird nichts aus einem Horoskop berechnet, daher sendest du weder Datum noch Uhrzeit noch Ort – ermittle die Stellung des Herrschers vorher selbst. Ein unbekannter Hausname oder eine Zahl außerhalb des Bereichs löst keinen Fehler aus, sondern liefert HTTP 200 mit dem String 'Invalid key: …'. Der einzige Key ist get_house_lord.

https://api.occultapi.com/api/astro/house_lord_particular_house/

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

Feld Typ Pflicht Hinweise

house

string

Feld	Typ	Pflicht	Hinweise
house	string	Pflicht	`lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya` Das Bhava, dessen HERRSCHER gemeint ist: lagna = 1. Haus ... vyaya = 12. Haus. WARNUNG: Dieser Endpoint verwendet ANDERE Namen als /api/astro/effect_house_lord_different_house/ – hier heißen das 5./6./7./8./9. Haus 'putra', 'satru', 'yuvati', 'randhara' (beachte das zusätzliche 'a': randhAra) und 'dharma'. Wird in Kleinbuchstaben umgewandelt. Ein unbekannter Wert liefert 200 mit "Invalid key: <x>".
keys	array	Pflicht	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_lord` Array von Strings; es gibt nur einen Key.
number	integer	Pflicht	`123456789101112` Ganzzahl 1-12 – das Haus, in dem dieser Herrscher steht. Ein Wert außerhalb des Bereichs liefert 200 mit "Invalid key: <n>".

Pflicht

lagnadhanasahajasukhaputrasatruyuvatirandharadharmakarmalabhavyaya

Das Bhava, dessen HERRSCHER gemeint ist: lagna = 1. Haus ... vyaya = 12. Haus. WARNUNG: Dieser Endpoint verwendet ANDERE Namen als /api/astro/effect_house_lord_different_house/ – hier heißen das 5./6./7./8./9. Haus 'putra', 'satru', 'yuvati', 'randhara' (beachte das zusätzliche 'a': randhAra) und 'dharma'. Wird in Kleinbuchstaben umgewandelt. Ein unbekannter Wert liefert 200 mit "Invalid key: <x>".

keys

array

Pflicht

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_lord

Array von Strings; es gibt nur einen Key.

number

integer

Pflicht

123456789101112

Ganzzahl 1-12 – das Haus, in dem dieser Herrscher steht. Ein Wert außerhalb des Bereichs liefert 200 mit "Invalid key: <n>".

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.

Key	Zusätzliche Felder	Beschreibung
get_house_lord	house, number	Die klassischen Ergebnisse, wenn der Herrscher eines Hauses in einem anderen Haus steht: house nennt das Bhava, dessen Herrscher er ist, number das Haus, in dem er steht. Liefert eine Liste kurzer englischer Aussagen, meist eine bis drei, etwa 'Blessed with paternal and maternal happiness'. Referenztext, nach dem Paar nachgeschlagen; nichts davon wird aus einem Horoskop abgeleitet.

Beispielanfrage

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

Antwort

{
  "data": {
    "get_house_lord": [
      "Blessed with paternal and maternal happiness",
      "Gains many brothers, is charming, virtuous, and has a passionate nature"
    ]
  },
  "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.