# Construisez avec l'API astrologique AstroWay

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

API astrologique · v1

700+ endpoints, trois SDK propriétaires, précision Swiss Ephemeris. Tarif anonyme - commencez sans clé.

[Obtenir une clé gratuite](https://api.astroway.info/dashboard/sign-up) Démarrage rapide 10K crédits/mois · sans carte

## Démarrage rapide

Obtenez votre horoscope quotidien sans clé API :

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

### Inscrivez-vous pour obtenir une clé gratuite

[Obtenez une clé gratuite - 10 000 crédits/mois, sans carte](https://api.astroway.info/dashboard/sign-up)

### Première requête avec votre clé

```
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"
```

Consultez [tarifs](https://astroway.info/shop/) pour les limites de tarifs et le coût des crédits par endpoint.

## Authentification

Trois tarifs. Choisissez le vôtre.

| Tarif | Authentification | Limites | Filigrane |
| --- | --- | --- | --- |
| **Anonyme** | sans clé | uniquement /v1/embed/* · 30 requêtes/heure par IP | oui |
| **Clé gratuite** | `X-Api-Key: aw_live_…` | 10K crédits/mois | oui |
| **Payant** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3,5M | Non (Pro+) |

### Liaison au domaine

Les clés payantes sont liées à un seul domaine lors de la première requête. Il est possible de le modifier soi-même dans l'espace client, jusqu'à 3 fois par mois. L'installation du plugin WordPress envoie automatiquement l'en-tête X-AstroWay-Site-URL sans modifier le code.

### Gestion des erreurs

- `401` — clé API X-Api-Key absente ou invalide
- `402` — l'abonnement ne comprend pas cet endpoint (ex. : endpoint HD sans Pack HD)
- `403` — inadéquation de domaine (domaine lié ≠ en-tête Origin)
- `429` — limite de requêtes dépassée ou crédits mensuels épuisés (en-tête Retry-After défini)

## Widgets intégrés

iframe direct - fonctionne sur tout site HTML, sans chargeur JS. Tarif anonyme, 30 requêtes/heure par IP de visiteur.

### Horoscope quotidien

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

### Roue de la carte 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>
```

### Carte du jour Tarot

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

### Phase Lunaire

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

### Installation sur WordPress

Installez [plugin AstroWay pour WordPress ↗](https://wordpress.org/plugins/astroway/) - widgets Tier 1 sans configuration, shortcodes à copier, clé API optionnelle pour Tier 2/3.

## SDK officiels

Trois SDK natifs. Typage fort complet, générés à partir d'OpenAPI 3.1. Licence MIT. Avec réessais et opérations idempotentes.

### 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 · généré à partir d'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 · modèles 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 · promesses Guzzle

### WordPress

Site WordPress ? Le plugin gratuit [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) ajoute des thèmes natals, des horoscopes, le Tarot, la numérologie et le Human Design via des shortcodes et des blocs Gutenberg - sans code. Fonctionne de manière anonyme ou avec votre clé API.

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

### Agents LLM / IA

Nous publions [/llms.txt ↗](https://api.astroway.info/llms.txt) pour détecter les agents d'IA. La famille d'endpoints `/v1/context/*` renvoie un XML optimisé pour les LLM, directement consommable par les intégrations ChatGPT / Claude / Gemini.

### Serveur MCP (Pro+)

Serveur natif Model Context Protocol sur mcp.astroway.info - connectez Claude Desktop ou tout client MCP pour interroger l'ensemble de l'API en mode conversationnel. Inclus dans les forfaits Pro et Business.