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

Katalogkarte: So sind die 700+ Endpoints von AstroWay aufgebaut

Die API ist auf über 700 Endpoints in 57 Gruppen gewachsen, vom Geburtshoroskop über BaZi und Geomantie bis zum Rendern von SVG-Horoskopen. Wir zeigen, wie der Katalog in Domänen gegliedert ist, nach welchem einheitlichen Muster alle Aufrufe funktionieren und wie man schnell den passenden Endpoint findet.

Der AstroWay-Katalog umfasst bereits 865 Endpunkte in 57 Gruppen. Bei diesem Umfang ist die Hauptfrage für einen Integrator nicht “reicht die Abdeckung aus?”, sondern “wie verliere ich nicht den Überblick?”. Dieser Artikel ist eine Karte: wie der Katalog in Domänen unterteilt ist und wie du das Gesuchte in einer Minute findest.

Unabhängig von der Domäne hat jeder Berechnungs-Endpunkt die gleiche Form:

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

Der Body ist ein JSON mit Geburtsdaten (Datum, Uhrzeit, Koordinaten) oder technikspezifischen Parametern. Die Antwort ist immer { "ok": true, "data": {...} } oder { "ok": false, "error": {...} }. Kein GraphQL, keine separaten Auth-Flows pro Domäne: ein Schlüssel im X-Api-Key-Header, ein Antwortformat.

Das bedeutet, dass der Wrapper, den du für ein Geburtshoroskop schreibst, auch für BaZi und Runen geeignet ist – nur der Pfad und das Body-Schema ändern sich.

Der Katalog ist in große Domänen gruppiert. Hier ist eine Karte mit den tatsächlichen Zählern (die Zahlen werden bei jedem Build aus dem Manifest entnommen, daher sind sie hier immer aktuell):

DomäneEndpunkteInhalt
Westliche Astrologie186Geburtshoroskop, Aspekte, Würden, Prognostik (Transite, Progressionen, Direktionen), Horar, 4 hellenistische Schulen, moderne psychologische, evolutionäre, Kosmobiologie
Vedische Astrologie230Die größte Domäne: Nakshatras, Dashas, Divisional-Karten (Varga), Yogas, Dosha, Jaimini, KP, Ashtakavarga, Shadbala
Human Design12Bodygraph, Kanäle, Tore, Typ/Profil/Autorität, Inkarnationskreuz
Tarot71Drei Decks: Rider-Waite-Smith, Marseille, Lenormand – Legungen, Bedeutungen, Kombinationen
Numerologie555 Systeme mit 10 Berechnungen (pythagoräisch, chaldäisch, zwei kabbalistische, vedisch)
Chinesisch + Maya55BaZi (Vier Säulen), Zi Wei Dou Shu, chinesischer Tierkreis und Feng Shui, Maya-Kalender
Wahrsagerei40Geomantie (Agrippa), Runen des Älteren Futhark, Handlesekunst (Cheiro), I Ching
Angewandte Nischen53Wellness, Tierastrologie, Business, Finanzen, Familie
Berichte29Fertige Interpretationen (Natal, Synastry), in HTML/PDF, mit White-Label-Branding
Render14SVG/PNG-Kartenräder, Bodygraph, Transitringe – ohne eigenes Frontend
Dev-Tools47Webhooks, Echtzeit-Streaming, einbettbare Widgets, White-Label

Der Rest sind KI-Interpretationen, Horoskope, Referenz-Endpunkte (Zeichen, Planeten, Aspekte) und System-Endpunkte (Health, Usage, OpenAPI).

230 vedische Endpunkte sind mehr als der gesamte westliche Teil. Der Grund ist einfach: Die vedische Tradition ist formalisierter. Wo die westliche Astrologie einen Satz von Häusern hat, hat die vedische 16 Divisional-Karten (Varga), mehrere Dasha-Systeme, Dutzende von Yogas mit klaren Regeln. Jedes davon ist ein separater Endpunkt mit einem deterministischen Ergebnis.

Wenn du für den indischen Markt entwickelst, ist dies der Kern des Produkts, nicht ein Add-on.

Unabhängig von der Exotik der Technik werden die Planetenpositionen von einem einzigen Kern mit einer Genauigkeit von einer Bogensekunde berechnet, die mit NASA JPL Horizons abgeglichen wurde. Derselbe Kern arbeitet sowohl in unserer Anwendung als auch in der API – eine Codebasis, keine Abweichungen. Die Berechnungs-Endpunkte sind mit 888 Snapshot-Tests abgedeckt, die bei jedem PR mit Referenzquellen abgeglichen werden. Mehr dazu in einem separaten Artikel über CI-Präzision.

Drei Wege, beginnend mit dem schnellsten:

  1. OpenAPI-Referenz – /docs/api/ wird direkt aus der Produktionsspezifikation openapi.json generiert. Die Gruppen in der Seitenleiste = die Domänen oben. Jeder Endpunkt hat ein Body-Schema, ein Beispiel und einen “Ausprobieren”-Button.
  2. MCP-Katalog – Wenn du Claude oder Cursor verwendest, ist der gesamte Katalog als Toolset über mcp.astroway.info verfügbar. Der Agent findet den benötigten Endpunkt selbst anhand der Beschreibung.
  3. Suche in der Spezifikation – curl https://api.astroway.info/v1/openapi.json liefert den vollständigen maschinenlesbaren Vertrag. Praktisch für die Codegenerierung deines eigenen Clients.

Ein Schlüssel auf dashboard/sign-up gibt dir 10.000 Kredite pro Monat – genug, um Dutzende von Domänen zu erkunden und herauszufinden, was davon für dich relevant ist. Du musst den Katalog nicht vollständig studieren: Nimm deine Domäne, der Rest wartet, bis du ihn brauchst.

MakSeong · AstroWay

Ich entwickle das AstroWay API: packe Astrologie-Mathematik auf die Bogensekunde in reines REST und schreibe über langweilige Details, die eigentlich wichtig sind.

// darauf aufbauen

Positionen auf die Bogensekunde 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 SDKs: TypeScript, Python, PHP statt rohem curl

Rohes HTTP funktioniert, aber ein typisierter Client spart Stunden: Autovervollständigung der Pfade, Request- und Response-Typen, eingebauter Retry bei 408/409/429/5xx und eine Fehlerhierarchie im Stainless-Stil. Wir gehen die drei offiziellen SDKs durch, @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist), und zeigen, wie sie aus einem einzigen OpenAPI-Vertrag generiert werden.

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.