Playground lädt
curl -X POST https://api.occultapi.com/api/astro/transit/solar-ingress/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2025-01-01T00:00:00+00:00","tz":0,"when":"after","x2cross":0}'Wann die Sonne als Nächstes eine bestimmte ekliptikale Länge erreicht. Die Berechnung hinter jeder Frage nach einem Sonnen-Ingress: Übergib 0 für den Eintritt in den Widder, 90 für den Krebs, 180 für die Waage, 270 für den Steinbock – oder einen beliebigen anderen Grad. Das Überschreiten von 0 Grad Widder IST die März-Tagundnachtgleiche, und dieser Endpoint liefert denselben Zeitpunkt wie /api/astro/seasons/. Nur Vorwärtssuche. Die Rückwärtssuche des Rechenkerns ist unzuverlässig – bei einem Ziel von 0 Grad liefert sie dasselbe Datum wie die Vorwärtssuche, bei 90 ein Datum ein Jahr später –, daher wird sie nicht angeboten. Nicht zu verwechseln mit /api/astro/sankranti/, das die SIDERISCHEN Sankranti-Termine des Hindu-Kalenders liefert. Die beiden unterscheiden sich um das Ayanamsa.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| date_time | string (date-time) | Pflicht | Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten. |
| celestial | string | optional | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node |
| celestial1 | string | optional | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node |
| celestial2 | string | optional | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node |
| datetime_end | string (date-time) | optional | |
| datetime_start | string (date-time) | optional | |
| degr | number (double) | optional | min 0 · max 360 |
| keys | array | optional | 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. |
| latitude | number (double) | optional | Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen. min -90 · max 90 |
| longitude | number (double) | optional | 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 | string | optional | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutomean_nodetrue_node |
| timezone_as_float | number (double) | optional | UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset. min -12 · max 14 |
| tz | number (double) | optional | UTC-Offset, in dem die gelieferten Zeiten angegeben werden. min -12 · max 14 |
| when | string | optional | Nur vorwärts; siehe den Modul-Docstring zu `before`. after |
| x2cross | number (double) | optional | Zu überschreitende ekliptikale Länge, 0-360 ab 0° Widder. min 0 · max 360 |