FAQ answers

Généralités

Qu’est-ce que l’API AstroWay ?

Une API HTTP professionnelle dédiée aux calculs astrologiques. 714 endpoints basés sur Swiss Ephemeris (WASM) : thèmes natals, synastrie, progressions, directions, transits, Human Design, astro-cartographie, rectification, interprétations par IA. Tous les calculs sont effectués côté serveur — aucune dépendance côté client.

À qui s’adresse cette API ?

Aux développeurs qui construisent des applications astrologiques (web/mobile), aux entreprises d’IA ajoutant des fonctionnalités astrologiques, aux astrologues professionnels utilisant des scripts, et aux chercheurs ayant besoin d’un accès programmatique aux calculs.

Quelle est la précision des calculs ?

Swiss Ephemeris garantit une précision des positions planétaires à ±1 seconde d’arc, et des cuspides des maisons à ±1 minute d’arc. Les résultats sont vérifiés par rapport à Astrodienst (Astro.com), Solar Fire, Zet 9 et Kepler. Dérive inférieure à la seconde d’arc par rapport aux éphémérides NASA JPL et au catalogue des éclipses NASA sur 5 millénaires.

Comment AstroWay se compare-t-il à Astro.com ou Solar Fire ?

Moteur identique Swiss Ephemeris — celui utilisé par Solar Fire ($495 de licence), Kepler ($995), Astro Gold ($29,99/mois) et Astrodienst (Astro.com). Validé contre les éphémérides NASA JPL et le test de référence swetest officiel d’Astrodienst. Dérive inférieure à 0,1” pour les positions planétaires et ≤1 minute pour les éclipses. Différence : AstroWay est une API REST à partir de $5/mois au lieu d’une licence one-time ou d’une interface desktop.

Quels systèmes de maisons sont pris en charge ?

15 systèmes : Placidus (par défaut), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentrique, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski-Pisa, Hindu Bhava, APC et Equal depuis MC. Transmets le code correspondant dans le paramètre houseSystem.

Crédits et paiement

Comment fonctionne le système de crédits ?

Chaque endpoint a un coût fixe en crédits (de 10 à 500), selon la complexité du calcul. Une simple recherche coûte 10 crédits, un thème natal 20, une synastrie 50, et une rectification 500. Le tableau complet est disponible sur la page Tarifs.

Existe-t-il un tarif gratuit ?

Oui. Le plan Free offre 10 000 crédits/mois, avec 10 requêtes/minute. Aucune carte bancaire requise. Suffisant pour évaluer le produit et prototyper.

Que se passe-t-il lorsque les crédits sont épuisés ?

Sur le plan Free, les requêtes sont bloquées jusqu’au mois suivant (429 CREDITS_EXHAUSTED). Sur les plans Indie/Starter/Pro/Business, un overage est appliqué : $5 / $3 / $2 pour 10 000 crédits supplémentaires.

Les requêtes identiques sont-elles mises en cache ?

Oui. Une entrée identique dans les 5 minutes retourne un résultat en cache sans déduction de crédits. Confirmé par l’en-tête X-Cache: HIT.

Peut-on acheter des crédits sans abonnement ?

Pas encore. L’abonnement offre un budget prévisible et une meilleure limite de débit. Un plan pay-as-you-go est prévu.

Technique

Quels SDK sont disponibles ?

• Serveur MCP ✅ publié : npx -y @astroway/mcp — expose les 714+ endpoints comme outils pour Claude $1, Cursor, GPT et autres agents IA compatibles MCP
• SDK TypeScript ✅ publié : npm install @astroway/sdk — typage + autocomplétion avec OpenAPI 3.1, gestion des retry et idempotence, erreurs au style Stainless
• SDK Python ✅ publié : pip install astroway — Astroway synchrone + AsyncAstroway asynchrone, basé sur httpx, typage PEP 561
• SDK PHP ✅ publié : composer require astroway/sdk — PHP 8.1+, Guzzle 7 + PSR-18, middleware de retry
• Go / Ruby / Rust 📋 prévu — inscris-toi pour recevoir une notification par email sur la page de chaque SDK (/sdk/<language>/)

Le contrat de l’API est standard REST + JSON, donc tout client HTTP fonctionne sans SDK. Une collection Postman et une spécification OpenAPI 3.1 sont disponibles publiquement.

Existe-t-il un mode sandbox ?

Oui. Les clés aw_test_* ne déduisent pas de crédits et retournent les mêmes résultats. Idéal pour le développement et les tests.

Quelle est la limite de débit (rate limit) ?

Elle dépend du plan : Free — 10, Indie — 30, Starter — 120, Pro — 400, Business — 1 000 requêtes/minute. En cas de dépassement, un code 429 est retourné avec l’en-tête Retry-After.

Le zodiaque sidéral est-il pris en charge ?

Oui. Transmets "zodiacType": "sidereal" et optionnellement "ayanamsaId" (Lahiri par défaut). Fonctionne avec tous les endpoints.

Que sont les endpoints Human Design ?

12 endpoints pour calculer le Human Design : type, stratégie, autorité, profil, définition, croix d’incarnation, canaux, centres, Dream Rave, Hologenetic Profile, Penta (dynamique de groupe), sensibilité temporelle. La couverture la plus complète du HD parmi les API commerciales.

Sécurité et confidentialité

Les données des requêtes sont-elles stockées ?

L’API fonctionne en mode stateless — les données de date/heure/coordonnées de naissance ne sont pas conservées après traitement de la requête. Seuls les métadonnées sont enregistrées : key_id, endpoint, timestamp, latence, crédits. Aucune donnée personnelle.

L’API est-elle conforme au RGPD ?

Oui. Aucune donnée n’est stockée. Pour les utilisateurs de l’UE : aucune PII n’est traitée, aucun profilage, aucun cookie. La clé API est liée au compte, pas à l’utilisateur final.

Les interprétations par IA sont-elles sûres ?

Les endpoints IA (/interpret/*, /horoscope/*) intègrent des garde-fous intégrés : interdiction des conseils médicaux, juridiques ou financiers. Chaque réponse inclut un disclaimer. Un historique d’audit complet est disponible pour la conformité en entreprise.

Support

Comment obtenir de l’aide ?

Cela dépend du plan : Free — communauté, Indie — email (48h), Starter — email (24h), Pro — email (4h), Business — email + Slack (1h), Enterprise — gestionnaire dédié sur Slack. Les contacts sont disponibles sur la page Contact.

Existe-t-il un SLA ?

Indie : 99 % de disponibilité. Starter et Pro : 99,9 %. Business : 99,95 %. Enterprise : SLA personnalisé avec garanties financières.