POST/api/astro/ashtamsa/1 Credit

Ashtamsa (D8)

Das Ashtamsa, das achte Teilhoroskop: jedes Zeichen in acht Teile zu je 3°45' geteilt. Wird für Langlebigkeit, plötzliche Ereignisse und Erbschaften herangezogen – also für die Themen des 8. Hauses, gesondert betrachtet. Nicht Teil des Shodasavarga. Liefert dieselbe flache Struktur wie /api/astro/planet-positions/: die Planeten als Liste in traditioneller Reihenfolge, jeweils mit `name`, Länge, Zeichen, Nakshatra, Pada und Haus, dazu der Aszendent und das angewandte Ayanamsa. Die Route legt das Horoskop fest, daher wird ein `chart_name` im Body ignoriert statt berücksichtigt – dieser Endpoint kann nur diese Teilung liefern.

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

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
chart_name	string	Pflicht
datetime	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. Bedeutet dasselbe wie date_time; andere Endpoints verwenden für dasselbe Feld nur einen anderen Namen.
latitude	number (double)	Pflicht	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 -89.9 · max 89.9
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
aberration	boolean	optional
apply_correction	boolean	optional
ascendant_pos	string	optional	`cuspstartend`
ayanamsa	string	optional
background_color	string	optional	Hex-Farbe für den SVG-Hintergrund.
chart_style	string	optional	Diagrammstil bei render='svg'. 'north' ist das Rautenlayout mit festen Häusern und wandernden Zeichen; 'south' ist das Raster mit festen Zeichen und wandernden Häusern. `northsouth`
correction_deg	integer	optional	min 0
correction_direction	string	optional	`addsubtract`
correction_min	integer	optional	min 0 · max 59
correction_sec	integer	optional	min 0 · max 59
extended_bodies	array	optional	Welche Gruppen von Himmelskörpern einbezogen werden: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	optional	Wie die Planeten beschriftet werden: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) oder 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	optional	Hex-Farbe für die Rasterlinien des Horoskops.
notation	string	optional	`astrologicaldegree`
nutation	boolean	optional
planet_color	string	optional	Hex-Farbe für die Planetenbeschriftungen, z. B. '#111827'. Standardmäßig die Farbe des Themes.
rahu	string	optional	Welche Mondknoten einbezogen werden. 'true' liefert nur die wahren, 'mean' nur die mittleren Mondknoten, 'both' liefert beide. `truemeanboth`
refraction	boolean	optional
render	string	optional	Setze den Wert auf 'svg', um zusätzlich ein gerendertes Horoskopdiagramm (siehe chart_style) samt der zugrunde liegenden Geometrie zu erhalten. Lässt du das Feld ganz weg, bleibt die Antwort unverändert. `nonesvg`
show_degrees	boolean	optional	Zeigt neben der Beschriftung jedes Himmelskörpers seinen Grad im Zeichen an.
sign_color	string	optional	Hex-Farbe für Zeichennummern/-abkürzungen.
svg_size	integer	optional	Breite und Höhe der quadratischen SVG-viewBox in Pixeln. min 100 · max 2000
theme	string	optional	`lightdark`
true_mean	string	optional	`TrueMean`
use_28_nakshatras	boolean	optional

Beispielanfrage

Dieses Beispiel ist noch nicht geprüft

Feldnamen und Typen unten stammen aus der API-Definition und stimmen. Genau dieser Body war bei unserem letzten Testlauf aber nicht erfolgreich – vielleicht fehlt ein Wert, den wir nicht ableiten können. Nimm ihn als Ausgangspunkt, nicht als fertigen Befehl.

curl -X POST https://api.occultapi.com/api/astro/ashtamsa/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"chart_name":"string","datetime":"2026-09-01 06:00:00","latitude":26.9124,"longitude":75.7873,"ascendant_pos":"cusp","chart_style":"north","correction_direction":"add","label_style":"english","notation":"astrological","rahu":"true","render":"none","theme":"light","true_mean":"True"}'

Antwort

Für diesen Endpoint gibt es noch keine geprüfte Beispielantwort. Die Anfragestruktur oben wird aus der API-Definition erzeugt und stimmt. Beispielantworten veröffentlichen wir erst, wenn ein echter Aufruf sie bestätigt hat.

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.