/api/astro/ayanamsa_value/1 CreditAyanamsa-Wert
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.
https://api.occultapi.com/api/astro/ayanamsa_value/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_…Query-Parameter (2)
Sie stehen in der URL. Alle sind optional, sofern nicht anders markiert, und lassen sich kombinieren: erst filtern, dann blättern, dann sortieren.
| 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. |
Beispielanfrage
curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"Antwort
{
"ayanamsa": "LAHIRI",
"date": "2026-09-07",
"value_degrees": 24.229844,
"degrees": 24,
"minutes": 13,
"seconds": 47,
"formatted": "24°13'47\""
}Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.
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.