FAQ answers

Allgemeines

Was ist die AstroWay API?

Professionelle HTTP API für astrologische Berechnungen. 771 Endpoint auf Basis der Swiss Ephemeris: Geburtshoroskope, Synastrie, Progressionen, Direktionen, Transite, Human Design, Astrokartografie, Retrokorrektur, KI-Interpretationen. Alle Berechnungen laufen auf dem Server – keine Abhängigkeiten auf der Client‑Seite.

Für wen ist diese API?

Für Entwickler, die astrologische Anwendungen (Web/Mobile) bauen, AI‑Unternehmen, die astrologische Funktionen hinzufügen, professionelle Astrologen mit Skripten und Forscher, die programmatischen Zugriff auf Berechnungen benötigen.

Wie genau sind die Berechnungen?

Swiss Ephemeris liefert eine Genauigkeit der planetarischen Positionen von ±1 Bogensekunde, der Hauscusps von ±1 Bogenminute. Die Ergebnisse wurden gegen Astrodienst (Astro.com), Solar Fire, Zet 9 und Kepler verifiziert. Sub‑Arcsecond‑Drift gegenüber NASA JPL Ephemeris und dem NASA 5‑Millennium Eclipse Catalog.

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

Identischer Swiss‑Ephemeris‑Engine – derselbe, der in Solar Fire ($495 Lizenz), Kepler ($995), Astro Gold ($29.99/міс) und Astrodienst (Astro.com) verwendet wird. Validiert gegen NASA JPL Ephemeris und das offizielle swetest‑Reference von Astrodienst. Sub‑Arcsecond‑Drift (≤0.1″) bei planetarischen Positionen, ≤1 Minute bei Sonnen‑/Mondfinsternissen. Unterschied: AstroWay – REST API von $5/міс statt one-time license oder desktop GUI.

Welche Haus­systeme werden unterstützt?

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

Kredite und Zahlung

Wie funktioniert das Kreditsystem?

Jeder Endpoint hat einen festen Preis in Krediten (von 10 bis 500), abhängig von der Komplexität der Berechnung. Einfacher Lookup – 10, Geburtshoroskop – 20, Synastrie – 50, Retrokorrektur – 500. Die vollständige Tabelle findest du auf der Seite Tarife.

Gibt es einen kostenlosen Tarif?

Ja. Der Free‑Plan gibt 10 000 Kredite/Monat, 10 req/min. Keine Karteneingabe nötig. Ausreichend, um das Produkt zu testen und Prototypen zu bauen.

Was passiert, wenn die Kredite aufgebraucht sind?

Im Free‑Plan werden Anfragen bis zum nächsten Monat blockiert (429 CREDITS_EXHAUSTED). In Indie/Starter/Pro/Business wird ein Over‑age aktiviert: $5 / $3 / $2 für jeweils 10 000 zusätzliche Kredite.

Werden gleiche Anfragen gecached?

Ja. Identische Eingaben innerhalb von 5 Minuten werden aus dem Cache zurückgegeben, ohne Kredite zu verbrauchen. Bestätigt durch den Header X-Cache: HIT.

Kann man Kredite ohne Abonnement kaufen?

Noch nicht. Ein Abonnement bietet ein vorhersehbares Budget und ein besseres Rate‑Limit. Pay‑as‑you‑go ist in Planung.

Technisches

Welche SDKs sind verfügbar?

• MCP‑Server ✅ realisiert: npx -y @astroway/mcp: exponiert alle 771+ Endpunkte als Werkzeuge für Claude Desktop, Cursor, GPT und andere MCP‑kompatible KI‑Agenten
• TypeScript SDK ✅ realisiert: npm install @astroway/sdk: Typen + Autocomplete aus OpenAPI 3.1, Retry + Idempotency, Stainless‑style Fehler
• Python SDK ✅ realisiert: pip install astroway: sync Astroway + async AsyncAstroway, basierend auf httpx, PEP 561 typisiert
• PHP SDK ✅ realisiert: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR‑18, Retry‑Middleware
• Go / Ruby / Rust 📋 geplant: Abonniere Benachrichtigungen per E‑Mail auf der Seite jedes SDK (/sdk/<language>/)

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

Gibt es einen Sandbox‑Modus?

Ja. Schlüssel aw_test_* verbrauchen keine Kredite und liefern dieselben Ergebnisse zurück. Ideal für Entwicklung und Tests.

Wie hoch ist das Rate‑Limit?

Abhängig vom Plan: Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. Bei Überschreitung: 429 mit Header Retry-After.

Wird der siderische Tierkreis unterstützt?

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

Was sind die Human‑Design‑Endpoints?

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

Sicherheit und Datenschutz

Werden Anfragedaten gespeichert?

Die API ist stateless – Daten zu Datum/Uhrzeit/Koordinaten der Geburt werden nach der Anfrage nicht gespeichert. Es werden nur Metadaten geloggt: key_id, Endpoint, timestamp, latency, Kredite. 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 die KI‑Interpretationen sicher?

AI‑Endpoints (/interpret/*, /horoscope/*) haben eingebaute Safety‑Guardrails: Verbot von medizinischen, rechtlichen und finanziellen Ratschlägen. Jede Antwort enthält einen Disclaimer. Vollständiger Audit‑Trail – für Enterprise‑Compliance.

Support

Wie bekommst du Hilfe?

Abhängig vom Plan: 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 Manager in Slack. Kontakte findest du auf der Seite Kontakt.

Gibt es ein SLA?

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

Ähnliche Namen

Ist die AstroWay API (astroway.info) mit dem “Astroway”-Abonnement von astroway.life verbunden?

Nein. astroway.info und api.astroway.info – das ist ein separates, unabhängiges Unternehmen. Wir bieten ein astrologisches API für Entwickler (api.astroway.info), eine Anwendung für Endnutzer (app.astroway.info) und astrologische Beratungen. Wir haben keinerlei Verbindung zu dem Verbraucher‑Astrologie‑Abonnement, das unter dem Namen “Astroway” über astroway.life beworben und abgebucht wird (E‑Mails von no-reply@astroway.life, Person “Celeste”, im Kontoauszug – “Astroway”). Der Betreiber dieses Abonnements ist TrafficLeader OÜ (Estland, auch traffic-leader.com); der zugehörige Biller SKYREAD.PRO ist ABCMobile OÜ (Estland). Nur die ähnliche Namensähnlichkeit stimmt – es sind verschiedene Unternehmen.

Wird mir “Astroway” berechnet – wie kündige ich das Abonnement und bekomme Geld zurück?

Wenn dir das Abonnement “Astroway” (E‑Mails von no-reply@astroway.life, im Kontoauszug – “Astroway”) berechnet wird, ist das ein anderes Unternehmen, astroway.life, nicht wir. Wir haben keinen Zugriff auf dein Konto oder Zahlungen in diesem Service, daher können wir das Abonnement nicht kündigen oder Geld zurückerstatten. So gehst du vor:

1. Antworte direkt auf die E‑Mail von no-reply@astroway.life und nutze den Link “abmelden / kündigen” im Footer.
2. Wenn keine Reaktion erfolgt: Kontaktiere deine Bank oder den Kartenaussteller (Zahlung im Auszug – “Astroway”; Händler – TrafficLeader OÜ oder ABCMobile OÜ / SKYREAD.PRO, Estland) und bitte um Blockierung weiterer Abbuchungen oder um ein Rückbuchverfahren (chargeback).