POST/api/astro/planet_transit_natal_planets/1 Credit

Transit über Radixplanet

Vorformulierte Deutungen für einen Planeten, der über die Geburtsposition eines anderen Planeten läuft – Transit-Saturn über den Radix-Mond, Transit-Jupiter über die Radix-Sonne und so weiter. Das ist die paarweise Transittabelle, auf der die meisten Transitberichte aufbauen. Der Endpoint schlägt nur nach, er berechnet kein Horoskop: Gib den Transitplaneten als `planet` und den Planeten des Geburtshoroskops als `natal_planet` an, und du erhältst den Text. Ermittle zuerst mit einer Transitberechnung wie `/api/astro/transit/`, welche Kontakte tatsächlich bestehen, und rufe dann diesen Endpoint für den Text auf. Beide Argumente akzeptieren die neun Himmelskörper, auf der Transitseite fehlt allerdings Venus. Die Reihenfolge ist wichtig: Saturn über der Radix-Sonne ist ein anderer Eintrag als die Sonne über dem Radix-Saturn.

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

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
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.
natal_planet	string	Pflicht	`sunmoonmarsmercuryjupitervenussaturnrahuketu` Exakter Abgleich in Kleinbuchstaben. Alle 9 sind unter jedem Transitplaneten vorhanden (geprüft per AST-Parsing der Zuordnung). Ein unbekannter Wert liefert "Invalid key: <x>" mit HTTP 200.
planet	string	Pflicht	`sunmoonmarsmercuryjupitersaturnrahuketu` HINWEIS: 'venus' FEHLT als Transitplanet – die Zuordnung hat nur diese 8 Schlüssel auf oberster Ebene. Ein unbekannter Wert liefert "Invalid key: <x>" mit HTTP 200.

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_natal_planets	planet, natal_planet	Die Deutung für `planet` im Transit über die Geburtsposition von `natal_planet`. Liefert eine Liste kurzer Aussagen, meist zwei bis vier, jede für sich ein Satz zu diesem Kontakt. Das Paar hat eine Richtung: Transitplanet und Radixplanet sind nicht austauschbar.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/planet_transit_natal_planets/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_natal_planets"],"planet":"Sun","natal_planet":"sun"}'

Antwort

{
  "data": {
    "get_planet_transit_natal_planets": [
      "Start of a new solar cycle",
      "Brings new energy, optimism, and enthusiasm"
    ]
  },
  "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.