AstroWay API-Dokumentation

Last updated 25. Sept. 2026 Als Markdown öffnen Agenten-Setup

Der Hub der technischen Dokumentation von AstroWay API. 865 Endpoints auf Basis von Swiss Ephemeris, eine maschinenlesbare OpenAPI-Spezifikation, fertige Collections für Postman und Insomnia, offizielle SDKs für TypeScript, Python und PHP, ein MCP-Server für Claude/Cursor.

Reference

API Reference Vollständiger Katalog der 865 Endpoints: Parameter, Response-Schemas, Fehlercodes. Wird bei jedem Release aus der OpenAPI-Spezifikation generiert.

OpenAPI specification Maschinenlesbare Spezifikation. Importiere sie in Postman/Insomnia oder generiere dein eigenes SDK mit openapi-generator.

Postman collection Importfertige Collection mit Beispielen für jeden Endpoint.

Per-endpoint cost Kosten in Credits für jeden Endpoint, von 0 bis 500 Credits.

Einstieg

Schnellstart Registrieren, Schlüssel holen, den ersten Aufruf in 5 Minuten machen.

Authentifizierung X-Api-Key vs. Bearer, live (aw_live_*) vs. sandbox (aw_test_*), JWT für das Dashboard.

Credits und Limits Credit-Pooling, monatliche Kontingente, Rate Limits je Plan.

Sprachunterstützung 21 aktive Sprachen. Lokalisierung der Responses über `Accept-Language` (Textinhalte).

SDKs und Integrationen

TypeScript SDK Offizielles Paket `@astroway/sdk` auf npm. ESM, Node 20+, browserkompatibel.

Python SDK Offizielles Paket `astroway` auf PyPI. Sync- und Async-Clients, Python 3.9+.

PHP SDK Offizielles Paket `astroway/sdk` auf Packagist. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp`: Model-Context-Protocol-Server für Claude Desktop, Cursor und andere KI-Agenten.

Engineering

Rechengenauigkeit Swiss Ephemeris mit Bogensekunden-Präzision. CI-Snapshot-Tests gegen den NASA Eclipse Catalog.

Fehler Liste der Error Codes, HTTP-Status und Aufbau des Error Envelope.

Idempotency `Idempotency-Key`-Header für sichere Retries bei POST.

Versionierung Wie wir Versionen hochzählen, was die Kompatibilität bricht, wie man das Changelog liest.

Szenarien und Beispiele

Produktübersicht Vier Produktgruppen: Birth Chart, Human Design, Synastry, Horoscope.

Vedische Astrologie 354+ Endpoints für Vedic: Vargas, Dashas (8 Systeme), Panchang, Shadbala, Yogas, Doshas.

Codebeispiele Fertige Snippets für Geburtshoroskop, Synastrie, Transite, Human Design, MCP.

Use cases Integrationsszenarien für Astrologie-Apps, KI-Agenten und Dating-Plattformen.

Änderung vorschlagen