# Panoramica

**AstroWay API** — un backend professionale per calcoli astrologici come servizio.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoint basati su Swiss Ephemeris (WASM), con copertura di tecniche che nessun competitor offre: armoniche, carte draconiche, CCG, settori di Gauquelin, Human Design completo, rettificazione.

## Per chi è pensato

1. **Sviluppatori di applicazioni astrologiche** (web, mobile) che hanno bisogno di calcoli precisi e diversificati senza gestire un'infrastruttura di calcolo propria.
2. **Aziende AI** che integrano funzioni astrologiche — è disponibile un server MCP nativo per Claude, ChatGPT e altri agenti.
3. **Astrologi professionisti** che costruiscono i propri strumenti o script per i clienti.
4. **Ricercatori** che necessitano di accesso programmabile ai calcoli per studi statistici.
5. **Piattaforme di contenuti** che aggiungono funzionalità astrologiche a prodotti esistenti.

## Per chi **non** è pensato

- Widget oroscopici "segno di oggi" senza controllo — le AI-interpretazioni e gli oroscopi sono disponibili (`/interpret/*`, `/horoscope/*`), ma sono progettati come API per sviluppatori, non come widget pronti all'uso.
- Astrologia vedica come specializzazione principale — per progetti Vedic-first (sistemi Dasha, Panchang, KP), Prokerala e VedicAstroAPI sono più forti. Per l'astrologia occidentale + Human Design + tecniche rare (rettificazione, armoniche, CCG), AstroWay è superiore. Dai un'occhiata a /compare/.
- Tarocchi/numerologia — solo astrologia e Human Design. Lo I-Ching è disponibile come endpoint bonus.

## Cosa rende AstroWay unico

### 1. Tecniche rare in formato API

| Tecnica | A cosa serve |
|---|---|
| **Carte armoniche** (H2–H180) | Astrologia di ricerca (metodo di John Addey) |
| **Carta draconica** | Astrologia karmica/spirituale |
| **CCG (Cyclo-Carto-Graphy)** | Astrocartografia progressiva — tecnica premium di Jim Lewis |
| **Settori di Gauquelin** | Astrologia statistica, uso accademico |
| **Progressioni terziarie** | Terzo tipo di progressioni — di nicchia ma apprezzato |
| **Antiscie / contro-antiscie** | Tecnica ellenistica classica — rinascita delle scuole tradizionali |
| **Aspetti paralleli** | Aspetti per declinazione — pratiche avanzate |
| **Rettificazione tramite API** | Correzione dell'ora di nascita — valore altissimo |
| **Cicli planetari** (congiunzioni) | Astrologia mundana — eventi mondiali |
| **Indice ciclico di Barbault** | Astrologia mundana |
| **Minimo di Algol** | Tempi di stelle fisse — astrologia elettiva |
| **Linee di spazio locale** | Astrologia simile al Feng Shui |
| **Catene di disposizione** | Grafi di controllo — tecnica classica |
| **Almutem figuris** | Tecnica medievale — rinascita delle tradizioni |

### 2. Precisione di Swiss Ephemeris — lo stesso motore di Solar Fire ($495), Kepler ($995), Astro Gold

Lo stesso Swiss Ephemeris (LGPL) utilizzato dagli astrologi professionisti in Solar Fire, Kepler, Astro Gold e Janus da oltre 30 anni — solo in versione WASM e come REST API, senza markup intermedi. Precisione:

- Posizioni planetarie: ±1 secondo d'arco vs ephemeridi NASA JPL
- Cuspididi delle case: ±1 minuto d'arco
- Validazione incrociata con Zet 9, Solar Fire (ephemeridi proprietarie), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — differenze entro il margine di errore del metodo (≤0.1″).

### 3. {siteMeta.endpoints} endpoint — copertura approfondita delle tecniche occidentali

{siteMeta.westernCount} endpoint di calcolo per l'astrologia occidentale (4 scuole: ellenistica, psicologica moderna, evolutiva, cosmobiologia) + interpretazioni AI + Human Design completo. Profondità invece di dispersione su decine di direzioni.

## Architettura

```
La tua applicazione
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Calcolo e risposta in JSON
```

- I calcoli vengono eseguiti **sul server** — nessun blob WASM lato frontend della tua applicazione, nessuna questione di licenza su Swiss Ephemeris.
- Lo stato non viene memorizzato lato server — ogni richiesta è autosufficiente. Nessuna fuga di dati sui client.
- Le chiavi API sono legate al piano, al rate limit e al saldo giornaliero di crediti. Monitoraggio tramite dashboard.

## Prossimi passi

- [Guida rapida](/getting-started/) — prima richiesta in 5 minuti
- [Autenticazione](/authentication/) — come ottenere e memorizzare la chiave
- [Crediti e limiti](/rate-limits-credits/) — come funziona la fatturazione
- [Documentazione API](/docs/api/) — tutti gli endpoint con playground interattivo