Playground lädt
curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"Das Ayanamsa ist der Abstand zwischen dem tropischen Tierkreis, der an der Tagundnachtgleiche ausgerichtet ist, und dem siderischen Tierkreis der vedischen Astrologie, der an den Sternen ausgerichtet ist. Es wächst um etwa fünfzig Bogensekunden pro Jahr; jede siderische Berechnung hängt also davon ab, welches Ayanamsa du für welches Datum ansetzt. Dieser Endpoint liefert genau diese eine Zahl. Er wird per GET mit Query-Parametern aufgerufen: `ayanamsa`, ein Name wie LAHIRI, RAMAN, KRISHNAMURTI oder TRUE_CITRA (47 Standarddefinitionen werden akzeptiert, ohne Beachtung der Groß-/Kleinschreibung), und `date`, ein ISO-Datum, standardmäßig heute. Damit kannst du ein Horoskop mit dem Ayanamsa beschriften, mit dem es erstellt wurde, oder prüfen, wie weit zwei Definitionen für ein bestimmtes Geburtsdatum auseinanderliegen. Die Antwort enthält den Wert in zwei Formen: `value_degrees` als Dezimalzahl mit sechs Nachkommastellen sowie `degrees`, `minutes` und `seconds` plus einen fertig formatierten String `formatted`. Name und aufgelöstes Datum werden unverändert zurückgegeben. Ein unbekannter Name und das Pseudo-Ayanamsa 'USER' liefern 400.
| Parameter | Typ | Beispiel | Bedeutung | |
|---|---|---|---|---|
| ayanamsa | string | — | Name des Ayanamsa (z. B. LAHIRI). Standardwert: LAHIRI. GET-Query-Parameter. Groß-/Kleinschreibung spielt keine Rolle (.strip.upper). Standardwert: 'LAHIRI'. 'USER' lehnt dieser Endpoint ausdrücklich ab, obwohl der Ephemeriden-Rechenkern den Wert kennt. Unbekannte Werte liefern 400 {"error": "Unknown ayanamsa..."}. erlaubt: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC | |
| date | string | — | ISO-Datumsstring (z. B. 1990-05-14). Standardwert: heute. FORMATVORGABE, kein Enum. Alles, was Pythons datetime.fromisoformat akzeptiert: 'YYYY-MM-DD' oder ein vollständiger ISO-8601-Zeitstempel, z. B. '1990-05-14' / '1990-05-14T12:30:00'. Ein Zeitzonen-Offset im String wird VERWORFEN und durch UTC ersetzt. Standardwert: heute (UTC). Ein ungültiges Format liefert 400. |