/api/astro/chaturvimsamsa/1 CreditChaturvimsamsa (D24)
Das Chaturvimsamsa, das vierundzwanzigste Teilhoroskop, auch Siddhamsa genannt: jedes Zeichen in vierundzwanzig Teile zu je 1°15' geteilt. Wird für Bildung und Lernen herangezogen – nicht für erworbene Abschlüsse, sondern für das, was man tatsächlich beherrscht. 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/chaturvimsamsa/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/jsonFelder 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/chaturvimsamsa/ \
-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.