Playground lädt
curl -X POST https://api.occultapi.com/api/astro/house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["set_house_method"],"latitude":26.9124,"longitude":26.1046,"timezone_as_float":5.5,"method_name":"equal","notation":"astrological","date_time":"2024-11-18"}'Die zwölf Häuser für einen Zeitpunkt und einen Ort, in dem Häusersystem, das du angibst. In der vedischen Praxis gelten meist ganze Zeichen als Häuser, dieser Endpoint bietet aber die volle Auswahl der Ephemeride – Placidus, Koch, Campanus, Regiomontanus, Sripati, Porphyrius, äquale Häuser und Ganzzeichenhäuser, insgesamt zwei Dutzend Systeme. So kannst du dasselbe Horoskop in dem System erstellen, das eine bestimmte Tradition erwartet. Die Positionen sind siderisch. Entscheidend ist der Unterschied zwischen Häuserspitze und Bereich. Die Häuserspitze ist der einzelne Grad, den das System einem Haus zuweist; der Bereich ist die Spanne, die das Haus tatsächlich einnimmt. Er wird hier über die Mittelpunkte zwischen benachbarten Häuserspitzen berechnet: Ein Haus reicht von der Mitte zur vorherigen Häuserspitze bis zur Mitte zur nächsten. `house_cusps` liefert die zwölf Häuserspitzen, `house_starts` und `house_ends` die beiden Ränder, `house_ranges` beide Ränder zusammen und `houses` alle drei auf einmal. `notation` legt die Einheiten für die gesamte Antwort fest: 'degree' für rohe Dezimalgrad entlang der Ekliptik, 'astrological' für Zeichen plus Grad, Minuten und Sekunden. Bei `method_name` wird die Groß-/Kleinschreibung beachtet, und mehrere Werte enthalten Leerzeichen oder Satzzeichen – kopiere sie also exakt. Das System wird schon beim Aufbau der Anfrage aus `method_name` übernommen; `set_house_method` und `change_house_system` brauchst du daher nur, wenn du innerhalb eines Aufrufs mit mehreren Keys das System wechseln willst.
| 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. FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen). |
| 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. set_house_methodhouseshouse_rangeshouse_startshouse_cuspshouse_endschange_house_systemArray von Strings. 'set_house_method' und 'change_house_system' verwenden `method_name`; die anderen fünf verwenden `notation`. |
| method_name | string | Pflicht | equalalcabitiuscampanusequal (mc)carter poli-equ.gauquelin sectorshorizon/azimutsunshinesavard-akochpullen sdmorinusGroß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. Mehrere Werte enthalten Leerzeichen, Schrägstriche oder Satzzeichen – kopiere sie exakt, z. B. 'equal (mc)', 'carter poli-equ.', 'horizon/azimut'. |
| notation | string | Pflicht | astrologicaldegreeGroß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. 'degree' liefert rohe Dezimalgrad, 'astrological' Zeichen + G/M/S. Alles andere liefert 400. |
| timezone_as_float | number (double) | Pflicht | 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 |
| 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 -89.9 · max 89.9 |
| 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 |
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 | |
|---|---|---|---|
| change_house_system | method_name | Dieselbe Operation wie `set_house_method`: schaltet auf das in `method_name` genannte System um und liefert null. Beide Keys rufen denselben Code auf; es gibt keinen Unterschied. | |
| house_cusps | notation | Die zwölf Häuserspitzen, wie das gewählte Häusersystem sie festlegt, als flache Liste in Hausreihenfolge. Das sind die Grade der Häuserspitzen selbst, nicht die Hausgrenzen – die Grenzen stehen in `house_starts` und `house_ends` und liegen jeweils in der Mitte zwischen zwei aufeinanderfolgenden Häuserspitzen. | |
| house_ends | notation | Nur der Endrand jedes Hauses, als flache Liste mit zwölf Werten in Hausreihenfolge. Jeder Wert ist der Mittelpunkt zwischen der Häuserspitze dieses Hauses und der nächsten; das Ende von Haus n ist also gleich dem Beginn von Haus n+1. | |
| house_ranges | notation | Der Bereich, den jedes Haus einnimmt, als Objekt mit den Schlüsseln '1' bis '12' und jeweils `start` und `end`. Die Ränder sind die Mittelpunkte zwischen benachbarten Häuserspitzen: Ein Haus beginnt in der Mitte zur vorherigen Häuserspitze und endet in der Mitte zur nächsten. In der Notation 'degree' sind die Werte Dezimalgrad, in 'astrological' Objekte aus Zeichen, Grad, Minuten und Sekunden. | |
| house_starts | notation | Nur der Anfangsrand jedes Hauses, als flache Liste mit zwölf Werten in Hausreihenfolge – nicht als Objekt mit den Hausnummern als Schlüsseln wie bei `house_ranges`. In der Notation 'degree' Dezimalgrad, in 'astrological' Objekte aus Zeichen und G/M/S. | |
| houses | notation | Zwölf Häuser mit den Schlüsseln `1` bis `12`, jedes als `{start, cusp, end}` – die beiden Grenzen und dazwischen die Häuserspitze. Beachte: Die Struktur weicht vom Key `houses` bei /api/astro/krishnamurti/ ab, der `{start, mid, end}` liefert und keine Häuserspitze enthält. `notation` legt die Einheiten fest: `degree` liefert Gleitkommazahlen, `astrological` Strings wie `"Aries 12 30 15"`. | |
| set_house_method | method_name | Berechnet die Häuserspitzen im Häusersystem aus `method_name` neu. Ein Schalter, kein Wert – er liefert null und wirkt nur auf die Keys, die im Array danach stehen. Das System wird schon beim Aufbau der Anfrage aus `method_name` übernommen; dieser Key ist also überflüssig, außer du wechselst mitten im Aufruf das System. |