AstroWay/api v2.190.0 · de
alle Systeme in Ordnung

Katalogkarte: Wie sind die 700+ AstroWay-Endpoints aufgebaut

Die API ist auf über 700 Endpoints in 57 Gruppen gewachsen - von Geburtstafeln über BaZi, Geomantie bis hin zum SVG-Karten-Rendering. Wir erklären, wie der Katalog in Domains unterteilt ist, nach welchem einheitlichen Muster alle Aufrufe funktionieren und wie man schnell den benötigten Endpoint findet.

Der AstroWay-Katalog umfasst bereits 758 Endpunkte in 57 Gruppen. Bei solchem Umfang ist die Hauptsorge des Integrators nicht “ob das Coverage reicht”, sondern “wie man sich nicht verliert”. Diese Seite ist eine Karte: wie der Katalog in Domänen und wie man den richtigen in einer Minute findet.

Unabhängig von der Domäne haben alle berechnenden Endpunkte die gleiche Form:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Der Körper ist ein JSON mit Geburtsdaten (Datum, Uhrzeit, Koordinaten) oder spezifischen Technik-Parametern. Die Antwort ist immer { "ok": true, "data": {...} } oder { "ok": false, "error": {...} }. Keine GraphQL, keine separaten Auth-Flows pro Domäne: ein Schlüssel im Header X-Api-Key, ein Format der Antwort.

Das bedeutet, dass die Hülle, die du schreibst, unter der Natal-Karte, passt und für BaZi und Run-Untersuchungen geändert wird, nur der Pfad und die Körper-Struktur.

Der Katalog wird in große Domänen gruppiert. Hier ist eine Karte mit realen Zählern (die Zahlen werden aus dem Manifest auf jedem Build genommen, daher sind sie immer aktuell):

DomäneEndpunkteWas drin ist
Westliche Astrologie182Natal-Karte, Aspekte, Helligkeiten, Prognosen (Transits, Progressionen, Direktionen), horary, 4 antike Schulen, moderne psychologische, evolutive, kosmobiologische
Vedic174Der größte Domäne: Nakshatras, Dasha, Divisional-Karten (Varga), Yogas, Dosha, Jaimini, KP, Ashtakavarga, Shadbala
Human Design12Bodygraph, Kanäle, Tore, Typ/Profil/Autorität, Inkarnationskreuz
Tarot66Drei Kartensätze: Rider-Waite-Smith, Marseille, Lenormand - Layouts, Bedeutungen, Kombinationen
Numerologie505 Systeme mit 10 Berechnungen (Pythagorean, Chaldean, zwei kabbalische, Vedic)
Chinesisch + Maya55BaZi (vier Säulen), Zi Wei Dou Shu, chinesischer Zodiak und Feng-Shui, Maya-Kalender
Wahrsagung31Geomantie (Agrippa), Runen des alten Futarch, Chiromantie (Cheiro), I Ching
Anwendungsbereiche51Wellness, Tier-Astrologie, Geschäft, Finanzen, Familie
Berichte23Vorbereite Interpretationen (Natal, Synastry), in HTML/PDF, mit white-label-Marketing
Render14SVG/PNG-Ringe, Bodygraph, Transitringe - ohne eigenen Frontend
Dev-Tools44Webhooks, Live-Streaming, eingebettete Widgets, white-label

Der Rest ist AI-Interpretationen, Horoskope, Referenz-Endpunkte (Zeichen, Planeten, Aspekte) und Systeme (Gesundheit, Nutzung, OpenAPI).

174 Vedic-Endpunkte sind mehr als die gesamte westliche Seite. Die Ursache ist einfach: die Vedic-Tradition ist formeller. Dort, wo westliche Astrologie einen Satz von Domains hat, hat Vedic 16 Divisional-Karten (Varga), mehrere Dasha-Systeme, Dutzende Yogas mit klaren Regeln. Jedes von diesem ist ein eigener Endpunkt mit einem bestimmten Ergebnis.

Wenn du unter indischen Bedingungen baut, ist dies das Herzstück des Produkts, nicht ein Zusatz.

Unabhängig von der Exotik der Technik werden Planetenpositionen mit einem Kern auf der Swiss Ephemeris (WASM) berechnet. Das gleiche Kern arbeitet sowohl im Browser-App als auch auf dem Server-API - eine gemeinsame Codebasis, kein Abweichen. Berechnende Endpunkte sind mit 873 Snapshot-Tests abgedeckt, die auf jedem PR mit etablierten Quellen verglichen werden. Einzelheiten dazu - in einer separaten Artikel über CI-Genauigkeit.

Drei Wege, von schnellsten:

  1. OpenAPI-Dokumentation - /docs/api/ wird direkt aus der Produkt-Spezifikation openapi.json generiert. Gruppen im Seitenleisten = Domänen oben. Jeder Endpunkt hat eine Körper-Struktur, ein Beispiel und eine “Versuch”-Schaltfläche.
  2. MCP-Katalog - Wenn du in Claude oder Cursor bist, ist der gesamte Katalog als eine Reihe von Werkzeugen über mcp.astroway.info verfügbar. Der Agent findet den richtigen Endpunkt nach Beschreibung.
  3. Suche nach Spezifikation - curl https://api.astroway.info/v1/openapi.json gibt den vollständigen maschinellen Kontrakt aus. Bequem für die Code-Generierung eines eigenen Clients.

Der Schlüssel auf dashboard/sign-up gibt 10.000 Krediten pro Monat - genug, um durch Dutzende Domänen zu gehen und zu verstehen, was hier ist. Der Katalog muss nicht gänzlich studiert werden: nimm deinen Domäne, und der Rest wartet, bis es nötig ist.

MakSeong · AstroWay

Ich entwickle das AstroWay API: packe Swiss Ephemeris in reines REST und schreibe über langweilige Details, die eigentlich wichtig sind.

// darauf aufbauen

Derselbe Swiss Ephemeris wie in Solar Fire - in 4 Zeilen Code.

Kostenloser Schlüssel ohne Kreditkarte. 5.000 Aufrufe pro Monat vor der ersten Zahlung.

Mehr aus dem Blog alle Beiträge →

Engineering 2026-07-15

Drei offizielle SDK: TypeScript, Python, PHP anstelle des rauen curl

Der räudige HTTP funktioniert, aber der typisierte Client spart Stunden: Autocomplete für Routen, Typen für Anfragen und Antworten, eingebauter retry für 408/409/429/5xx und eine Stahlschicht-Struktur für Fehler. Wir zerlegen die drei offiziellen SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - und aus welchem OpenAPI-Kontrakt sie generiert wurden.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.

Engineering 2026-06-05

Horoscope API Tutorial: Build a Daily Horoscope Feature

Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.