🕓 Note du 2026-04-14, mise à jour 2026-05-09. Les SDK TS / Python / PHP sont maintenant disponibles sur les registres publics —
@astroway/sdk(npm),astroway(PyPI),astroway/sdk(Packagist). Détails dans le changelog.
Tu veux calculer une carte natale avec du code. Voici le chemin le plus court — en 5 minutes, de zéro à un JSON fonctionnel.
Étape 1 : Obtenir une clé API (30 secondes)
Section intitulée « Étape 1 : Obtenir une clé API (30 secondes) »Inscris-toi sur api.astroway.info/dashboard/sign-up. Le plan gratuit : 10 000 crédits / mois. Pas de carte bancaire.
Dans le dashboard, clique sur « Create key » → « Production » → copie. Les clés ressemblent à aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR.
Conseil : il y a aussi des clés de test avec le préfixe aw_test_ — elles ne débitent pas les crédits. Utilise-les pendant le développement.
Étape 2 : Installer le SDK
Section intitulée « Étape 2 : Installer le SDK »TypeScript
Section intitulée « TypeScript »npm install @astroway/sdkpip install astrowayLes deux SDK couvrent tous les 723 avec des requêtes et des réponses typées.
Étape 3 : Première carte natale
Section intitulée « Étape 3 : Première carte natale »TypeScript
Section intitulée « TypeScript »import { Astroway } from '@astroway/sdk';
const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY!,});
const chart = await client.chart({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, // UTC+3, été à Kiev latitude: 50.4501, longitude: 30.5234, houseSystem: 'P', // Placidus});
console.log(`Soleil : ${chart.planets[0].sign} à ${chart.planets[0].longitude}°`);console.log(`ASC : ${chart.houses.ascendant}°`);console.log(`Aspects : ${chart.aspects.length}`);Exécute :
ASTROWAY_API_KEY=aw_live_... npx tsx chart.tsfrom astroway import Astroway
client = Astroway(api_key="aw_live_your_key_here")
chart = client.chart( date="1990-07-14", time="14:30:00", timezone_offset=3, latitude=50.4501, longitude=30.5234, house_system="P",)
print(f"Soleil : {chart['planets'][0]['sign']} à {chart['planets'][0]['longitude']}°")print(f"ASC : {chart['houses']['ascendant']}°")print(f"Aspects : {len(chart['aspects'])}")Exécute :
ASTROWAY_API_KEY=aw_live_... python3 chart.pyCe que retourne l’API
Section intitulée « Ce que retourne l’API »Un objet JSON avec quatre parties principales :
Un tableau de 12 objets (Soleil, Lune, Mercure, Vénus, Mars, Jupiter, Saturne, Uranus, Neptune, Pluton, Nœud Nord, Chiron) :
{ "name": "Soleil", "longitude": 111.87, // longitude écliptique en degrés "latitude": 0.0, "speed": 0.955, // degrés par jour (négatif = rétrograde) "sign": "cancer", "signIndex": 3, "house": 10, "retrograde": false}Les cusps des maisons (12) ainsi que l’ascendant et le MC :
{ "system": "P", "cusps": [12.34, 43.21, ...], // 12 valeurs "ascendant": 12.34, "mc": 280.12}Un tableau d’aspects entre les planètes :
{ "planet1": "Soleil", "planet2": "Lune", "type": "sextile", // conjonction, opposition, trine, carré, sextile, quincunx "orb": 1.36, // déviation de l'aspect exact en degrés "applying": true}chartSect
Section intitulée « chartSect »"diurnal" (Soleil au-dessus de l’horizon au moment de la naissance) ou "nocturnal" (en dessous de l’horizon). Utilisé en astrologie classique.
Que faire ensuite
Section intitulée « Que faire ensuite »Que faire ensuite :
Synastrie — compatibilité entre deux personnes :
const synastry = await client.synastry({ chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 }, chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },});console.log(`Score de compatibilité : ${synastry.compatibility.score}/100`);Transits actuels sur la carte natale :
const transits = await client.transits({ // données de naissance date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, // date du transit transitDate: '2026-04-14',});Horoscope quotidien avec des transits réels :
const horoscope = await client.horoscopeDaily({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(horoscope.text);Carte complète de Human Design :
const hd = await client.humanDesign({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(`${hd.type} — ${hd.strategy} — Profile ${hd.profile}`);Coût en crédits
Section intitulée « Coût en crédits »- Carte natale (
/chart) : 20 crédits - Synastrie : 50 crédits
- Transits : 50 crédits
- Horoscope quotidien : 20 crédits
- Human Design : 50 crédits
Plan gratuit : 10 000 crédits / mois = 500 cartes natales, ou 200 synastries, ou une charge mixte.
Gestion des erreurs
Section intitulée « Gestion des erreurs »Chaque réponse contient des en-têtes avec les crédits :
X-Credits-Used: 20X-Credits-Remaining: 4980X-Credits-Reset: 2026-05-01T00:00:00ZLorsque les crédits sont épuisés — tu reçois 402 Payment Required. Lorsque tu atteins la limite de taux (Free : 10 requêtes / min) — 429 Too Many Requests avec l’en-tête Retry-After.
Le SDK lance des erreurs typées que tu peux attraper :
try { const chart = await client.chart({ ... });} catch (err) { if (err.code === 'credits_exhausted') { console.log('Mettez à niveau le plan ou attendez la réinitialisation'); } else if (err.code === 'rate_limit_exceeded') { console.log(`Réessaye dans ${err.retryAfter} secondes`); }}Et c’est tout
Section intitulée « Et c’est tout »Maintenant, tu as :
- Une clé API fonctionnelle
- Le SDK installé
- La première carte natale
- Suffisamment d’exemples pour ajouter la synastrie, les transits, les horoscopes
Lis plus :
- Guide complet « pour commencer » — plus de détails
- Exemple : carte natale — walkthrough plus approfondi
- Référence API — tous les 723 points de terminaison
Le même Swiss Ephemeris que Solar Fire — en 4 lignes de code.
Clé gratuite sans carte. 5 000 appels par mois avant le premier paiement.