Documentazione di AstroWay API

Last updated 25 set 2026 Apri come Markdown Configurazione agente

L’hub della documentazione tecnica di AstroWay API. 865 endpoint basati su Swiss Ephemeris, una specifica OpenAPI leggibile dalle macchine, collezioni pronte per Postman e Insomnia, SDK ufficiali per TypeScript, Python e PHP, un server MCP per Claude/Cursor.

Reference

API Reference Catalogo completo di 865 endpoint: parametri, schemi delle risposte, codici di errore. Generato dalla specifica OpenAPI a ogni release.

OpenAPI specification Specifica leggibile dalle macchine. Importala 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 di ogni endpoint, da 0 a 500 crediti.

Per iniziare

Guida rapida Registrati, ottieni una chiave ed esegui la prima chiamata in 5 minuti.

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

Crediti e limiti Pooling dei crediti, quote mensili, rate limit per piano.

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

SDK e integrazioni

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

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

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

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

Ingegneria

Precisione dei calcoli Precisione al secondo d'arco con Swiss Ephemeris. Test snapshot in CI confrontati con il NASA Eclipse Catalog.

Errori Elenco degli error code, degli status HTTP e struttura dell'error envelope.

Idempotenza Header `Idempotency-Key` per ripetere in sicurezza le richieste POST.

Versionamento Come incrementiamo le versioni, cosa rompe la compatibilità, come leggere il changelog.

Scenari ed esempi

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

Astrologia vedica 354+ endpoint per l'astrologia vedica: Vargas, dashas (8 sistemi), Panchang, Shadbala, Yogas, Doshas.

Esempi di codice Snippet pronti per tema natale, sinastria, transiti, Human Design, MCP.

Use cases Scenari di integrazione per app di astrologia, agenti AI e piattaforme di dating.

Suggerisci modifica