FAQ answers

Allgemeines

Was ist die AstroWay API?

Professionelle HTTP-API für astrologische Berechnungen. 723 Endpunkte basierend auf Swiss Ephemeris (WASM): Geburtskarten, Synastrie, Progressionen, Direktionen, Transite, Human Design, Astrokartographie, Rektifikation, KI-Interpretationen. Alle Berechnungen erfolgen serverseitig – keine Client-Abhängigkeiten.

Für wen ist diese API gedacht?

Für Entwickler, die astrologische Anwendungen (Web/Mobile) erstellen, KI-Unternehmen, die astrologische Funktionen hinzufügen, professionelle Astrologen mit Skripten sowie Forscher, die programmatischen Zugriff auf Berechnungen benötigen.

Wie genau sind die Berechnungen?

Swiss Ephemeris bietet eine Genauigkeit der Planetenpositionen von bis zu ±1 Bogensekunde, der Häuserspitzen von bis zu ±1 Bogenminute. Die Ergebnisse wurden gegen Astrodienst (Astro.com), Solar Fire, Zet 9 und Kepler verifiziert. Sub-Bogensekunden-Abweichung gegenüber NASA JPL Ephemeris und dem NASA 5-Millennium-Eclipse-Katalog.

Wie vergleicht sich AstroWay mit Astro.com oder Solar Fire?

Identische Swiss-Ephemeris-Engine – dieselbe wie in Solar Fire ($495 Lizenz), Kepler ($995), Astro Gold ($29,99/Monat) und Astrodienst (Astro.com). Validiert gegen NASA JPL Ephemeris und den offiziellen swetest-Referenz von Astrodienst. Sub-Bogensekunden-Abweichung (≤0,1″) bei Planetenpositionen, ≤1 Minute bei Finsternissen. Unterschied: AstroWay ist eine REST-API ab $5/Monat statt einer Einmallizenz oder Desktop-GUI.

Welche Häusersysteme werden unterstützt?

15 Systeme: Placidus (Standard), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topozentrisch, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC und Equal MC. Übergebe den entsprechenden Code im Parameter houseSystem.

Guthaben und Bezahlung

Wie funktioniert das Guthabensystem?

Jeder Endpunkt hat feste Kosten in Guthaben (zwischen 10 und 500), abhängig von der Berechnungskomplexität. Einfacher Lookup kostet 10, eine Geburtskarte 20, Synastrie 50, Rektifikation 500. Die vollständige Tabelle findest du auf der Seite Preise.

Gibt es einen kostenlosen Tarif?

Ja. Der Free-Plan bietet 10.000 Guthaben/Monat, 10 Anfragen/Minute. Ohne Kreditkarteneingabe. Ausreichend für die Produktbewertung und Prototyping.

Was passiert, wenn das Guthaben aufgebraucht ist?

Beim Free-Plan werden Anfragen bis zum nächsten Monat blockiert (429 CREDITS_EXHAUSTED). Bei Indie/Starter/Pro/Business wird Overage berechnet: $5 / $3 / $2 für jeweils 10.000 zusätzliche Guthaben.

Werden identische Anfragen zwischengespeichert?

Ja. Identische Eingaben innerhalb von 5 Minuten werden aus dem Cache zurückgegeben, ohne dass Guthaben belastet wird. Bestätigt durch den Header X-Cache: HIT.

Kann man Guthaben ohne Abo kaufen?

Aktuell nicht. Das Abo bietet einen planbaren Budgetrahmen und bessere Rate-Limits. Ein Pay-as-you-go-Plan ist geplant.

Technisches

Welche SDKs sind verfügbar?

• MCP-Server ✅ veröffentlicht: npx -y @astroway/mcp – stellt alle 723+ Endpunkte als Tools für Claude $1, Cursor, GPT und andere MCP-kompatible KI-Agenten bereit
• TypeScript-SDK ✅ veröffentlicht: npm install @astroway/sdk – Typen + Autocomplete mit OpenAPI 3.1, Retry + Idempotenz, Stainless-Style-Fehler
• Python-SDK ✅ veröffentlicht: pip install astroway – synchron Astroway + asynchron AsyncAstroway, basierend auf httpx, PEP 561 typisiert
• PHP-SDK ✅ veröffentlicht: composer require astroway/sdk – PHP 8.1+, Guzzle 7 + PSR-18, Retry-Middleware
• Go / Ruby / Rust 📋 geplant – Benachrichtigung per E-Mail auf der Seite jedes SDK (/sdk/<language>/)

Der API-Vertrag ist ein standardmäßiger REST + JSON, sodass jeder HTTP-Client ohne SDK funktioniert. Postman-Collection und OpenAPI 3.1-Spezifikation sind öffentlich verfügbar.

Gibt es einen Sandbox-Modus?

Ja. Schlüssel mit dem Präfix aw_test_* belasten keine Guthaben und liefern dieselben Ergebnisse. Ideal für Entwicklung und Tests.

Wie hoch ist das Rate-Limit?

Abhängig vom Tarif: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1.000 Anfragen/Minute. Bei Überschreitung wird 429 mit dem Header Retry-After zurückgegeben.

Wird der siderische Tierkreis unterstützt?

Ja. Übergebe "zodiacType": "sidereal" und optional "ayanamsaId" (Standard ist Lahiri). Funktioniert mit allen Endpunkten.

Was sind die Human-Design-Endpunkte?

12 Endpunkte zur Berechnung von Human Design: Typ, Strategie, Autorität, Profil, Definition, Inkarnationskreuz, Kanäle, Zentren, Dream Rave, Hologenetic Profile, Penta (Gruppendynamik), zeitliche Empfindlichkeit. Die tiefste Abdeckung von HD unter den kommerziellen APIs.

Sicherheit und Datenschutz

Werden Anfragedaten gespeichert?

Die API arbeitet zustandslos – Daten zu Datum/Uhrzeit/Geburtskoordinaten werden nach der Verarbeitung der Anfrage nicht gespeichert. Es werden nur Metadaten protokolliert: key_id, Endpunkt, Timestamp, Latenz, Guthaben. Keine personenbezogenen Daten.

Entspricht die API den GDPR-Anforderungen?

Ja. Daten werden nicht gespeichert. Für Nutzer aus der EU: Keine Verarbeitung von PII, kein Profiling, keine Cookies. Der API-Key ist an das Konto gebunden, nicht an den Endnutzer.

Sind KI-Interpretationen sicher?

Die KI-Endpunkte (/interpret/*, /horoscope/*) verfügen über integrierte Sicherheitsvorkehrungen: Verbot von medizinischen, rechtlichen oder finanziellen Ratschlägen. Jede Antwort enthält einen Disclaimer. Vollständige Audit-Trails für Enterprise-Compliance.

Support

Wie erhalte ich Hilfe?

Abhängig vom Tarif: Free – Community, Indie – E-Mail (48 Std.), Starter – E-Mail (24 Std.), Pro – E-Mail (4 Std.), Business – E-Mail + Slack (1 Std.), Enterprise – dedizierter Slack-Manager. Kontaktdaten findest du auf der Seite Kontakt.

Gibt es SLAs?

Indie: 99 % Uptime. Starter und Pro: 99,9 % Uptime. Business: 99,95 % Uptime. Enterprise: individuelle SLAs mit finanziellen Garantien.