/api/astro/planet_transit_over_house/1 CreditTransit durch ein Haus
Vorformulierte Deutungen für einen Planeten im Transit durch ein bestimmtes Haus des Geburtshoroskops: was der Lauf der Sonne durch das dritte Haus bringen soll, was der Lauf Saturns durch das siebte bringen soll und so weiter, für neun Planeten in zwölf Häusern. Reines Nachschlagen – gib `planet` und `house` an und du erhältst den Text. Datum, Uhrzeit und Ort spielen keine Rolle; kombiniere den Endpoint also mit einer Berechnung, die dir sagt, in welchem Haus jeder Planet gerade steht. Nutze ihn zusammen mit `/api/astro/planet_transit_natal_planets/`, das die andere Hälfte eines Transitberichts abdeckt: den Kontakt eines Transitplaneten mit einem Radixplaneten statt mit einem Haus.
https://api.occultapi.com/api/astro/planet_transit_over_house/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/jsonFelder der Anfrage
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| house | integer | Pflicht | |
| 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. |
| planet | string | Pflicht | sunmoonmarsmercuryjupitervenussaturnrahuketuExakter Abgleich in Kleinbuchstaben. Ein unbekannter Wert liefert "Invalid key: <x>" mit HTTP 200. (Das zugehörige Feld `house` ist ein ganzzahliger Index in eine Liste, 0-basiert – siehe das Beispiel in __main__.) |
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_planet_transit_over_house | planet, house | Die Deutung für `planet` im Transit durch das in `house` angegebene Haus. Liefert eine Liste kurzer Aussagen, meist zwei bis vier, jede für sich ein Satz zu diesem Transit. |
Beispielanfrage
curl -X POST https://api.occultapi.com/api/astro/planet_transit_over_house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'Antwort
{
"data": {
"get_planet_transit_over_house": [
"Irritable temper",
"Gains physical strength, fame, and honour"
]
},
"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.