curl -X POST https://api.occultapi.com/api/planetary_details/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"start_date":"2024-11-21T08:33:35.539Z","end_date":"2024-11-22T08:33:35.539Z","longitude":76.125,"planet_name":"mercury","sign":"Taurus"}'Ein einziger Aufruf, der neun separate Ephemeriden-Scans über einen Zeitraum ausführt und die Ergebnisse gemeinsam liefert. Diesen Endpoint nimmst du, wenn du statt einer Momentaufnahme alles brauchst, was zwischen zwei Daten bei den Planeten geschieht: Zeichen- und Nakshatra-Wechsel, rückläufige Phasen, Deklinationsübereinstimmungen und Phasen außerhalb der Deklinationsgrenzen (Out of Bounds). `start_date` und `end_date` begrenzen das Zeitfenster, `planet_name` und `sign` grenzen die drei planetenspezifischen Abschnitte ein, und `longitude` ist der ekliptikale Grad, den die Positionssuche prüft. Gibst du `geo_latitude` und `geo_longitude` an, kommt ein zusätzlicher Abschnitt für den Aszendenten-Ingress hinzu; sonst fehlt er. Beachte: Das Zeitfenster wird vollständig durchsucht, ein mehrjähriger Zeitraum dauert daher erheblich länger als wenige Tage. Die Antwort enthält folgende Schlüssel (mit Leerzeichen im Namen): `sign transitions`, `planet at position` (wann der genannte Planet auf der angegebenen Länge im angegebenen Zeichen steht), `planet ingress exit` (Ein- und Austrittszeiten nur für den genannten Planeten im genannten Zeichen), `planet nakshatra ingress exit` (mit allen siebenundzwanzig Nakshatras als Schlüsseln, jeweils eine Liste von `{start_date, end_date}`-Zeitfenstern), `planet sankranti times` (mit jedem unterstützten Himmelskörper als Schlüssel, einschließlich der uranischen Punkte und Planetenmonde), `planet retrogression dates` (mit den Planeten als Schlüsseln, jeweils eine Liste von `{start, end}`), `planet krantisamya dates` (eine Liste von `{Planet_1, Planet_2, DateTime, Alignment}`, wobei Alignment North-North, South-South oder Opposite ist, also gleiche oder gespiegelte Deklination), `abhijit nakshatra periods` und `planet oob range` (die Phasen, in denen der Himmelskörper jenseits der maximalen Deklination der Sonne steht). Leere Listen bedeuten, dass in deinem Zeitfenster nichts dieser Art geschehen ist.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| end_date | string (date-time) | Pflicht | |
| longitude | number (double) | Pflicht | Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China. min -180 · max 180 |
| planet_name | string | Pflicht | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutotruenodemeannodeEines von: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, truenode, meannode. Kleingeschrieben. Andere Namen von Himmelskörpern akzeptiert die Validierung zwar, dafür gibt es aber keine Daten, und die Anfrage schlägt fehl. |
| sign | string | Pflicht | AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPiscesGROSS-/KLEINSCHREIBUNG WIRD BEACHTET – englische Zeichennamen mit großem Anfangsbuchstaben, exakt in dieser Schreibweise; 'aries' schlägt fehl. Wird außerdem genutzt, um das Ingress-/Exit-Ergebnis auf das angeforderte Zeichen einzuschränken. |
| start_date | string (date-time) | Pflicht | |
| geo_latitude | number (double) | optional | Geografischer Breitengrad des Beobachters (-90 bis 90). Erforderlich für die Daten zum Aszendenteneintritt. min -90 · max 90 |
| geo_longitude | number (double) | optional | Geografischer Längengrad des Beobachters (-180 bis 180). Erforderlich für die Daten zum Aszendenteneintritt. min -180 · max 180 |