astroAPI

Documentation

astroAPI Doku-Hub

Astrologische Berechnungen ueber eine einzige REST-API, gestuetzt auf die Swiss Ephemeris. Diese Seiten richten sich an Entwickler, die astroAPI in eine Anwendung einbauen wollen — von der ersten Anfrage bis zur Caching-Strategie.

Schnellstart

In drei Schritten zum ersten erfolgreichen Aufruf. cURL-Beispiel mit Demo-Key.

API-Referenz

Alle Endpunkte mit Parameter-Tabellen und Code-Beispielen in cURL, PHP, JavaScript und Python.

Authentifizierung & Limits

API-Keys, Rate-Limit-Header, HTTP-Caching mit ETag, Fehlerformat.

Client-Bibliotheken

Single-File-Helper fuer PHP, Python und JavaScript — keine Composer/pip/npm-Abhaengigkeit. Datei einbinden und losrechnen.

ReDoc-Spec

Vollstaendige OpenAPI-3.1-Spec, schoen aufbereitet — gut zum Stoebern und Browsen.

Playground

Endpunkte direkt im Browser ausprobieren, ohne eigenen Key.

Mini-Radix-Widget

Einbettbares Widget fuer fremde Sites — eine Script-Zeile, fertige Tabelle mit Planeten und Haeusern.

OpenAPI JSON

Maschinenlesbare Spec fuer Code-Generatoren (openapi-generator, prism, ...).

Wer ist das hier?

astroAPI deckt klassische westliche Astrologie ab: Radixkarten, Aspekte, Transite, Progressionen, Returns, Ekliptik- und Aequatorial- Positionen, Fixsterne und Asteroiden. Daneben hellenistische Spezialitaeten wie Wuerden, Profektionen, Firdaria und Zodiacal Releasing — und Hilfsendpunkte fuer Aufgaenge, Eclipses, Planeten- stunden, Patterns und mehr.

Alle Berechnungs-Endpunkte sind deterministisch: Identischer Eingabesatz produziert identische Antwort. Das macht HTTP-Caching billig und Tests reproduzierbar.

Aktuell live

  • 33+ Endpunkte
  • 1344 Fixsterne (erweiterte sefstars.txt)
  • 24.836 Asteroiden (mit MPC-Reverse-Lookup)
  • Swiss Ephemeris Pro als Berechnungsbasis