AstroWay API-documentatie
De hub voor de technische documentatie van AstroWay API. 865 endpoints op basis van Swiss Ephemeris, een machineleesbare OpenAPI-spec, kant-en-klare collecties voor Postman en Insomnia, officiële SDK’s voor TypeScript, Python en PHP, en een MCP-server voor Claude/Cursor.
Referentie
Section titled “Referentie” API Reference Volledige catalogus van 865 endpoints: parameters, response-schema's, foutcodes. Wordt bij elke release gegenereerd uit de OpenAPI-spec.
OpenAPI specification Machineleesbare spec. Importeer hem in Postman/Insomnia of genereer je eigen SDK met openapi-generator.
Postman collection Direct importeerbare collectie met voorbeelden voor elk endpoint.
Per-endpoint cost Kosten in credits per endpoint, van 0 tot 500 credits.
Aan de slag
Section titled “Aan de slag” Snelstart Registreer, haal een sleutel op en doe je eerste aanroep binnen 5 minuten.
Authenticatie X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT voor het dashboard.
Credits en limieten Pooling van credits, maandelijkse quota, rate limits per plan.
Taalondersteuning 21 actieve talen. Lokalisatie van responses via `Accept-Language` (tekstuele content).
SDK’s en integraties
Section titled “SDK’s en integraties” TypeScript SDK Officieel pakket `@astroway/sdk` op npm. ESM, Node 20+, browsercompatibel.
Python SDK Officieel pakket `astroway` op PyPI. Sync- en async-clients, Python 3.9+.
PHP SDK Officieel pakket `astroway/sdk` op Packagist. PSR-18 HTTP, PHP 8.1+.
MCP server `@astroway/mcp`: Model Context Protocol-server voor Claude Desktop, Cursor en andere AI-agents.
Engineering
Section titled “Engineering” Nauwkeurigheid van berekeningen Swiss Ephemeris met boogsecondenprecisie. CI-snapshottests tegen de NASA Eclipse Catalog.
Fouten Lijst met error codes, HTTP-statussen en de structuur van de error envelope.
Idempotency `Idempotency-Key`-header voor veilige retries bij POST.
Versiebeheer Hoe we versies ophogen, wat de compatibiliteit breekt en hoe je de changelog leest.
Scenario’s en voorbeelden
Section titled “Scenario’s en voorbeelden” Productoverzicht Vier productgroepen: Birth Chart, Human Design, Synastry, Horoscope.
Vedische astrologie 354+ endpoints voor Vedische astrologie: Vargas, dasha's (8 systemen), Panchang, Shadbala, Yogas, Doshas.
Codevoorbeelden Kant-en-klare snippets voor geboortehoroscoop, synastrie, transits, Human Design en MCP.
Use cases Integratiescenario's voor astrologie-apps, AI-agents en datingplatforms.