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"}'Vorformulierte Deutungen für einen einzelnen Planeten in einer bestimmten Stellung. Gib einen Planeten an und wo er steht – in einem Tierkreiszeichen, einem Haus oder einem Nakshatra –, und du erhältst die klassische Deutung für diese Kombination. Der Endpoint schlägt in einem Textkorpus nach, er rechnet nicht: Datum, Uhrzeit und Ort spielen keine Rolle, und dieselbe Anfrage liefert immer denselben Text. Damit beschriftest du ein Horoskop, das du bereits berechnet hast. Hol dir Zeichen, Haus und Nakshatra von Jupiter aus `/api/astro/chart/` und rufe dann diesen Endpoint für den Text auf. Alle drei Keys lassen sich in einem Aufruf anfordern, aber jeder braucht seinen eigenen zusätzlichen Parameter: Forderst du alle drei an, müssen `planet`, `sign`, `house` und `nakshatra` alle im Body stehen. Abgedeckt sind neun Planeten (die sieben klassischen plus Rahu und Ketu) in zwölf Zeichen und zwölf Häusern. Nakshatra-Deutungen gibt es nur für die sieben klassischen Planeten – für Rahu und Ketu nicht. Ein unbekannter Planet, ein unbekanntes Zeichen, Haus oder Nakshatra liefert keinen Fehler, sondern einen erklärenden String mit HTTP 200; prüfe also den Typ der Antwort, bevor du sie renderst.
| 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. |
| nakshatra | string | Pflicht | ashwinibharanikrittikarohinimrigasiraaardrapunarvasupushyamiaasreshamakhapoorva phalguniuttara phalguniDie Liste oben gilt für jupiter, mercury, venus und saturn. Für 'rahu' und 'ketu' gibt es überhaupt keine Nakshatra-Daten. Nicht passende Werte liefern "Invalid nakshatra: <x> for planet <p>" mit HTTP 200. |
| planet | string | Pflicht | sunmoonmarsmercuryjupitervenussaturnrahuketuEin unbekannter Planet liefert den String "Invalid planet: <x>" mit HTTP 200, keinen Fehlerstatus. Beachte: Für rahu und ketu gibt es KEINE Nakshatra-Daten (insights['rahu']['nakshatras'] is None); get_planet_nakshatra_insight liefert daher "No nakshatra data available for rahu". |
| sign | string | Pflicht | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesDATENFEHLER, den du kennen solltest: Bei planet='sun' ist der Schlüssel falsch als 'vigro' statt 'virgo' geschrieben. sun+virgo liefert daher "Invalid sign: virgo for planet sun", sun+vigro dagegen funktioniert. Alle acht anderen Planeten verwenden 'virgo'. |
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_house_insight | planet, house | Die Deutung für `planet` in einem Haus; `house` ist 1 bis 12. Liefert ein Objekt mit der Bezeichnung des Hauses, einer Zusammenfassung und Listen von Eigenschaften, dazu `classicalTexts` – eine Liste von `{heading, text}` mit Zitaten aus Parashara, Brihat Jataka, Saravali und Phaladipika zu dieser Stellung – und `houseLordVariations`, eine Liste von `{ascendent, aspect, result}`, die zeigt, wie sich die Deutung für jeden der zwölf Aszendenten ändert. Wo nur die klassischen Zitate vorliegen, sind einige Felder für Zusammenfassung und Eigenschaften null. | |
| get_planet_nakshatra_insight | planet, nakshatra | Die Deutung für `planet` in `nakshatra`, als ein oder zwei Sätze einfacher Text statt als strukturiertes Objekt. Verfügbar für die sieben klassischen Planeten in allen 27 Nakshatras; für Rahu und Ketu gibt es keine Nakshatra-Deutungen, sie liefern stattdessen einen erklärenden String. | |
| get_planet_sign_insight | planet, sign | Die Deutung für `planet` in `sign`. Liefert ein Objekt mit `sign` (der Sanskrit-Bezeichnung der Kombination, etwa "Mesa Brhaspati"), einem Absatz `summary` und den Listen `core traits`, `psychologicalPhysicalTraits`, `astrologicalReasoning` und `drstiphala`; die letzte beschreibt die Wirkung der Aspekte, die der Planet von dort aus wirft. Beachte das Leerzeichen im Feldnamen `core traits`. |