# Costruisci con l'API astrologico AstroWay

Source: https://astroway.info/it/developers/
Language: it
Updated: 2026-05-28

API astrologico · v1

700+ endpoint, tre SDK proprietari, precisione Swiss Ephemeris. Tariffa anonima - inizia senza chiave.

[Ottieni chiave gratuita](https://api.astroway.info/dashboard/sign-up) Guida rapida 10K crediti/mese · senza carta

## Guida rapida

Ricevi l'oroscopo quotidiano senza chiave API:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### Registrati per una chiave gratuita

[Ottieni una chiave gratuita - 10K crediti/mese, senza carta](https://api.astroway.info/dashboard/sign-up)

### Primo richiesta con la tua chiave

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

Guarda [tariffe](https://astroway.info/shop/) per i limiti delle tariffe e il costo dei crediti per endpoint.

## Autenticazione

Tre tariffe. Scegli la tua.

| Tariffa | Autenticazione | Limiti | Filigrana |
| --- | --- | --- | --- |
| **Anonimo** | senza chiave | solo \/v1\/embed\/* · 30 richieste\/ora per IP | sì |
| **Chiave gratuita** | `X-Api-Key: aw_live_…` | 10K crediti\/mese | sì |
| **A pagamento** | `X-Api-Key: aw_live_…` | Indie 50K \/ Starter 200K \/ Pro 800K \/ Business 3.5M | no (Pro+) |

### Associazione al dominio

Le chiavi a pagamento vengono associate a un unico dominio al primo request. È possibile modificarlo autonomamente nel pannello, fino a 3 volte al mese. L'installazione del plugin WordPress invia automaticamente l'intestazione X-AstroWay-Site-URL - senza modificare il codice.

### Gestione degli errori

- `401` — X-Api-Key mancante o non valido
- `402` — Il piano non include questo endpoint (es. endpoint HD senza HD Pack)
- `403` — Mancata corrispondenza del dominio (dominio associato ≠ intestazione Origin)
- `429` — Limite di richieste superato o crediti mensili esauriti (intestazione Retry-After impostata)

## Widget incorporati

Iframe diretto - funziona su qualsiasi sito HTML, senza caricatore JS. Tariffa anonima, 30 richieste/ora per IP del visitatore.

### Oroscopo giornaliero

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### Ruota del tema natale

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### Carta del giorno dei Tarocchi

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### Fase Lunare

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### Installazione su WordPress

Installa [plugin AstroWay per WP ↗](https://wordpress.org/plugins/astroway/) - widget Tier 1 senza configurazioni, shortcode da copiare, chiave API opzionale per Tier 2/3.

## SDK ufficiali

Tre SDK proprietari. Completamente tipizzati, generati da OpenAPI 3.1. Licenza MIT. Con tentativi ripetuti, idempotenti.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · generato da OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · modelli Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · client HTTP PSR-18 · promesse Guzzle

### WordPress

Sito su WordPress? Il plugin gratuito [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) aggiunge mappe natali, oroscopi, Tarocchi, numerologia e Human Design tramite shortcode e blocchi Gutenberg - senza codice. Funziona in modo anonimo o con la tua chiave API.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / agenti AI

Pubblicchiamo [/llms.txt ↗](https://api.astroway.info/llms.txt) per il rilevamento da parte di agenti AI. La famiglia di endpoint `/v1/context/*` restituisce XML ottimizzato per LLM per il consumo diretto da parte delle integrazioni ChatGPT / Claude / Gemini.

### MCP-server (Pro+)

Server nativo del Model Context Protocol su mcp.astroway.info - collega Claude Desktop o qualsiasi client MCP per interrogare l'intera API in modalità dialogica. Incluso nei piani Pro e Business.