# Aperçu

**AstroWay API** — un service backend professionnel pour les calculs astrologiques en tant que service.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints basés sur Swiss Ephemeris (WASM), couvrant des techniques introuvables chez les concurrents : harmoniques, cartes draconiques, CCG, secteurs de Gauquelin, Human Design complet, rectification.

## Pour qui est-ce fait ?

1. **Les développeurs d'applications astrologiques** (web, mobile) qui ont besoin de calculs précis et variés sans infrastructure de calcul propre.
2. **Les entreprises d'IA** intégrant des fonctionnalités astrologiques — un serveur MCP natif est disponible pour Claude, ChatGPT et d'autres agents.
3. **Les astrologues professionnels** qui construisent leurs propres outils ou scripts pour leurs clients.
4. **Les chercheurs** ayant besoin d'un accès programmatique aux calculs pour des études statistiques.
5. **Les plateformes de contenu** ajoutant des fonctionnalités astrologiques à un produit existant.

## Pour qui **ce n'est pas** fait ?

- Les widgets horoscopiques basiques « signe du jour » sans contrôle — les interprétations et horoscopes AI existent (`/interpret/*`, `/horoscope/*`), mais ils sont conçus comme une API pour les développeurs, pas comme un widget prêt à l'emploi.
- L'astrologie védique comme spécialisation principale — pour les projets Vedic-first (systèmes Dasha, Panchang, KP), Prokerala et VedicAstroAPI sont plus forts. Pour l'astrologie occidentale + Human Design + techniques rares (rectification, harmoniques, CCG), AstroWay les surpasse. Voir /compare/.
- Le Tarot/numérologie — seule l'astrologie et le Human Design sont couverts. Le Yi Jing est disponible en tant qu'endpoint bonus.

## Ce qui rend AstroWay unique

### 1. Techniques rares en format API

| Technique | À quoi ça sert |
|---|---|
| **Cartes harmoniques** (H2–H180) | Astrologie de recherche (méthode de John Addey) |
| **Carte draconique** | Astrologie karmique/spirituelle |
| **CCG (Cyclo-Carto-Graphy)** | Astro-cartographie progressive — technique premium de Jim Lewis |
| **Secteurs de Gauquelin** | Astrologie statistique, utilisation académique |
| **Progressions tertiaires** | Troisième type de progressions — niche mais très appréciée |
| **Antiscies / contre-antiscies** | Technique classique hellénistique — renaissance des écoles traditionnelles |
| **Aspects parallèles** | Aspects par déclinaison — pratiques avancées |
| **Rectification via API** | Correction de l'heure de naissance — valeur inestimable |
| **Cycles planétaires** (conjonctions) | Astrologie mondiale — événements mondiaux |
| **Indice cyclique de Barbault** | Astrologie mondiale |
| **Minimum d'Algol** | Moments des étoiles fixes — astrologie élective |
| **Lignes de l'espace local** | Astrologie directionnelle similaire au Feng Shui |
| **Chaînes de dispositors** | Graphes de contrôle — technique classique |
| **Almutens figuris** | Technique médiévale — renaissance traditionnelle |

### 2. Précision de Swiss Ephemeris — le même moteur que Solar Fire ($495), Kepler ($995), Astro Gold

Le même Swiss Ephemeris (LGPL) utilisé par les astrologues professionnels dans Solar Fire, Kepler, Astro Gold et Janus depuis plus de 30 ans — mais en version WASM et en tant que REST API, sans marge intermédiaire. Précision :

- Positions planétaires : ±1 seconde d'arc vs éphémérides NASA JPL
- Cusps des maisons : ±1 minute d'arc
- Validation contre Zet 9, Solar Fire (éphémérides propriétaires), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — écarts dans la limite de l'erreur de la méthode (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — une couverture approfondie des techniques occidentales

{siteMeta.westernCount} endpoints de calcul pour l'astrologie occidentale (4 écoles : hellénistique, psychologique moderne, évolutive, cosmobiologie) + interprétations AI + Human Design complet. Une profondeur plutôt qu'une dispersion sur des dizaines de directions.

## Architecture

```
Ton application
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Calcul et retour en JSON
```

- Les calculs sont effectués **sur le serveur** — aucun blob WASM sur le frontend de ton application, aucun problème de licence Swiss Ephemeris.
- Aucun état côté serveur n'est conservé — chaque requête est autonome. Aucune fuite de données clients.
- Les clés API sont liées au plan, au rate limit et au solde quotidien de crédits. Surveillance via le tableau de bord.

## Pour aller plus loin

- [Démarrage rapide](/getting-started/) — première requête en 5 minutes
- [Authentification](/authentication/) — comment obtenir et stocker ta clé
- [Crédits et limites](/rate-limits-credits/) — comment fonctionne la facturation
- [Documentation de l'API](/docs/api/) — tous les endpoints avec un playground interactif