FAQ answers

Generale

Cos’è l’API AstroWay?

API HTTP professionale per calcoli astrologici. 771 endpoint basati su Swiss Ephemeris: carte natali, sinastrie, progressioni, direzioni, transiti, Human Design, astrocartografia, rettificazione, interpretazioni AI. Tutti i calcoli sul server - nessuna dipendenza lato client.

Per chi è questo API?

Per sviluppatori che creano applicazioni astrologiche (web/mobile), aziende AI che aggiungono funzionalità astrologiche, astrologhi professionisti con script, e ricercatori che necessitano di accesso programmatico ai calcoli.

Qual è la precisione dei calcoli?

Swiss Ephemeris fornisce precisione delle posizioni planetarie fino a ±1 secondo d’arco, dei cuspi delle case fino a ±1 minuto d’arco. I risultati sono verificati contro Astrodienst (Astro.com), Solar Fire, Zet 9 e Kepler. Drift sub-arcsecond rispetto all’ephemeris NASA JPL e al catalogo delle eclissi NASA 5-Millennium.

Come si confronta AstroWay con Astro.com o Solar Fire?

Stesso motore Swiss Ephemeris - lo stesso di Solar Fire ($499 licenza), Kepler ($995), Astro Gold ($29.99/mese) e Astrodienst (Astro.com). Validato contro l’ephemeris NASA JPL e il riferimento ufficiale swetest di Astrodienst. Drift sub-arcsecond (≤0.1″) sulle posizioni planetarie, ≤1 minuto sulle eclissi. Differenza: AstroWay è un REST API da $5/mese invece di licenza one-time o interfaccia desktop GUI.

Quali sistemi di case sono supportati?

15 sistemi: Placidus (predefinito), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC e Equal da MC. Passa il codice corrispondente nel parametro houseSystem.

Crediti e pagamento

Come funziona il sistema di crediti?

Ogni endpoint ha un costo fisso in crediti (da 10 a 500), a seconda della complessità del calcolo. Lookup semplice - 10, carta natale - 20, sinastria - 50, rettificazione - 500. Tabella completa - sulla pagina Tariffe.

C’è un piano gratuito?

Sì. Il piano Free offre 10 000 crediti/mese, 10 req/min. Senza inserimento carta di credito. Abbastanza per valutare il prodotto e il prototipaggio.

Cosa succede quando i crediti esauriscono?

Su Free - le richieste vengono bloccate fino al mese successivo (429 CREDITS_EXHAUSTED). Su Indie/Starter/Pro/Business - si attiva l’overage: $5 / $3 / $2 per 10 000 crediti aggiuntivi.

Vengono memorizzati nella cache le richieste identiche?

Sì. Input identico entro 5 minuti viene restituito dalla cache senza addebito crediti. Confermato dall’header X-Cache: HIT.

È possibile acquistare crediti senza sottoscrizione?

Al momento no. La sottoscrizione offre un budget prevedibile e migliori limiti di frequenza. Il piano pay-as-you-go è previsto.

Tecnico

Quali SDK sono disponibili?

• MCP server ✅ rilasciato: npx -y @astroway/mcp: espone tutti gli endpoint 771+ come strumenti per Claude Desktop, Cursor, GPT e altri agenti AI compatibili con MCP
• TypeScript SDK ✅ rilasciato: npm install @astroway/sdk: tipi + autocomplete da OpenAPI 3.1, retry + idempotency, errori stile Stainless
• Python SDK ✅ rilasciato: pip install astroway: sync Astroway + async AsyncAstroway, basato su httpx, PEP 561 typed
• PHP SDK ✅ rilasciato: composer require astroway/sdk: PHP 8.1+, Guzzle 7 + PSR-18, retry middleware
• Go / Ruby / Rust 📋 previsto: iscriviti alla notifica via email sulla pagina di ogni SDK (/sdk/<language>/)

Il contratto API è REST + JSON standard, quindi qualsiasi client HTTP funziona senza SDK. Collezione Postman e specifica OpenAPI 3.1 disponibili pubblicamente.

C’è una modalità sandbox?

Sì. Le chiavi aw_test_* non addebitano crediti e restituiscono gli stessi risultati. Ideale per sviluppo e test.

Qual è il limite di frequenza?

Dipende dal piano: Free - 10, Indie - 30, Starter - 120, Pro - 400, Business - 1 000 req/min. In caso di superamento - 429 con header Retry-After.

È supportato lo zodiaco siderale?

Sì. Passa "zodiacType": "sidereal" e opzionalmente "ayanamsaId" (predefinito - Lahiri). Funziona con tutti gli endpoint.

Cos’è gli endpoint di Human Design?

12 endpoint per il calcolo di Human Design: tipo, strategia, autorità, profilo, definizione, incrocio incarnazionale, canali, centri, Dream Rave, Hologenetic Profile, Penta (dinamica di gruppo), sensibilità temporale. La copertura più profonda di HD tra gli API commerciali.

Sicurezza e privacy

Vengono salvati i dati delle richieste?

L’API è stateless - i dati data/ora/coordinate di nascita non vengono salvati dopo l’elaborazione della richiesta. Vengono registrati solo metadati: key_id, endpoint, timestamp, latenza, crediti. Nessun dato personale.

L’API è conforme al GDPR?

Sì. I dati non vengono salvati. Per utenti UE: nessuna elaborazione PII, nessun profiling, nessun cookie. La chiave API è associata all’account, non all’utente finale.

Le interpretazioni AI sono sicure?

Gli endpoint AI (/interpret/*, /horoscope/*) hanno safety guardrails incorporati: divieto di consigli medici, legali, finanziari. Ogni risposta include un disclaimer. Audit trail completo per la compliance enterprise.

Supporto

Come ottenere assistenza?

Dipende dal piano: Free - community, Indie - email (48 ore), Starter - email (24 ore), Pro - email (4 ore), Business - email + Slack (1 ora), Enterprise - manager dedicato in Slack. Contatti - sulla pagina Contatti.

C’è un SLA?

Indie: 99% uptime. Starter e Pro: 99.9% uptime. Business: 99.95% uptime. Enterprise: SLA personalizzato con garanzie finanziarie.

Nomi simili

L’API AstroWay (astroway.info) è collegato all’abbonamento “Astroway” di astroway.life?

No. astroway.info e api.astroway.info sono aziende separate e indipendenti. Forniamo un API astrologico per sviluppatori (api.astroway.info), un’app per utenti finali (app.astroway.info) e consulenze astrologiche. Non abbiamo alcun rapporto con l’abbonamento consumer di astrologia pubblicizzato e addebitato con il nome “Astroway” tramite astroway.life (email da no-reply@astroway.life, persona “Celeste”, estratto conto bancario - “Astroway”). L’operatore di questo abbonamento è TrafficLeader OÜ (Estonia, anche traffic-leader.com); il biller associato SKYREAD.PRO è ABCMobile OÜ (Estonia). Solo la somiglianza del nome è casuale - sono aziende diverse.

Mi addebita “Astroway” - come cancellare l’abbonamento e ottenere un rimborso?

Se ti addebitano per l’abbonamento “Astroway” (email da no-reply@astroway.life, estratto conto bancario - “Astroway”), questa è un’altra azienda, astroway.life, non noi. Non abbiamo accesso al tuo account o ai tuoi pagamenti su questo servizio, quindi non possiamo annullarli o rimborsarli. Cosa fare:

1. Rispondi direttamente all’email da no-reply@astroway.life e usa il link “unsubscribe / cancel” nel suo footer.
2. Se non rispondono: contatta la tua banca o l’emittente della carta (pagamento nell’estratto - “Astroway”; merchant - TrafficLeader OÜ o ABCMobile OÜ / SKYREAD.PRO, Estonia) e chiedi di bloccare ulteriori addebiti o di avviare un rimborso (chargeback).