Documentazione API AstroWay

Hub di documentazione tecnica AstroWay API. 761 endpoint su base Swiss Ephemeris, OpenAPI-spec che si può leggere, collezioni pronte per Postman e Insomnia, SDK ufficiali per TypeScript, Python e PHP, MCP-server per Claude/Cursor.

Reference

API Reference Catalogo completo di 761 endpoint: parametri, schemi di risposta, codici di errore. Generato con OpenAPI spec per ogni rilascio.

OpenAPI specification Spec che si può leggere. Importa in Postman/Insomnia o genera il tuo SDK con openapi-generator.

Postman collection Collezione pronta per l'importazione con esempi per ogni endpoint.

Costo per endpoint Costo in crediti per ogni endpoint - da 0 a 500 crediti.

Start

Avvio rapido Registrazione, ottieni la chiave, fai la prima chiamata in 5 minuti.

Autenticazione X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT per dashboard.

Credit e limiti Pulizia crediti, quote mensili, limiti di rate per piano.

Supporto delle lingue 21 lingue attive. Localizzazione delle risposte tramite `Accept-Language` (contenuto testuale).

SDK e integrazioni

SDK di TypeScript Pacchetto ufficiale `@astroway/sdk` su npm. ESM, Node 20+, browser-compatibile.

SDK di Python Pacchetto ufficiale `astroway` su PyPI. Clienti sync e async, Python 3.9+.

SDK di PHP Pacchetto ufficiale `astroway/sdk` su Packagist. PSR-18 HTTP, PHP 8.1+.

MCP-server `@astroway/mcp` - Model Context Protocol server per Claude Desktop, Cursor e altri agenti AI.

Ingegneria

Precisione dei calcoli Swiss Ephemeris precisione arc-second. CI-snapshot test contro catalogo NASA Eclipse.

Errori Elenco codici di errore, status HTTP e struttura dell'invio di errore.

Idempotenza Header `Idempotency-Key` per un retry sicuro su POST.

Versionamento Come siamo a bampiamo le versioni, come leggere il changelog.

Scegli e esempi

Panoramica dei prodotti Quattro gruppi di prodotti - Birth Chart, Human Design, Synastry, Horoscope.

Astrologia medica 354+ endpoint per Vedic - Vargas, dashas (8 sistemi), Panchang, Shadbala, Yogas, Doshas.

Esempi di codice Snippet pronti per carta natale, sinastri, transiti, Human Design, MCP.

Use cases Scegli e esempi di integrazione per astrazione, agenti AI e piattaforme di dating.