FAQ answers

Général

Qu’est-ce que l’API AstroWay ?

API HTTP professionnel pour les calculs astrologiques. 771 endpoint basé sur Swiss Ephemeris : cartes natales, synastrie, progressions, directions, transits, Human Design, astrocartographie, rectification, interprétations IA. Tous les calculs sont effectués sur le serveur – aucune dépendance côté client.

À qui s’adresse cette API ?

Pour les développeurs qui créent des applications astrologiques (web/mobile), les entreprises d’IA qui ajoutent des fonctions astrologiques, les astrologues professionnels avec des scripts, et les chercheurs qui ont besoin d’un accès programmatique aux calculs.

Quelle est la précision des calculs ?

Swiss Ephemeris assure une précision des positions planétaires à ±1 seconde d’arc, des cuspides des maisons à ±1 minute d’arc. Les résultats sont vérifiés contre Astrodienst (Astro.com), Solar Fire, Zet 9 et Kepler. Dérive sous‑arcsecondielle comparée aux éphémérides NASA JPL et au NASA 5‑Millennium Eclipse Catalog.

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

Moteur identique Swiss Ephemeris – le même que celui de Solar Fire (licence $495), Kepler ($995), Astro Gold ($29.99/mois) et Astrodienst (Astro.com). Validé contre les éphémérides NASA JPL et la référence officielle swetest d’Astrodienst. Dérive sous‑arcsecondielle (≤0.1″) sur les positions planétaires, ≤1 minute sur les éclipses. Différence : AstroWay – API REST à partir de $5/mois au lieu d’une licence unique ou d’une interface desktop.

Quelles systèmes de maisons sont supportés ?

15 systèmes : Placidus (par défaut), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Topocentric, Alcabitius, Morinus, Porphyrius, Vehlow, Krusinski‑Pisa, Hindu Bhava, APC et Equal de 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. Lookup simple – 10, carte natale – 20, synastrie – 50, rectification – 500. Le tableau complet est sur la page Tarifs.

Y a-t-il un forfait gratuit ?

Oui. Le plan Free offre 10 000 crédits/mois, 10 req/min. Aucun renseignement de carte requis. Suffisant pour évaluer le produit et prototyper.

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

Sur Free – les requêtes sont bloquées jusqu’au mois suivant (429 CREDITS_EXHAUSTED). Sur Indie/Starter/Pro/Business – un dépassement s’active : $5 / $3 / $2 pour 10 000 crédits supplémentaires.

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

Oui. Un input identique pendant 5 minutes est renvoyé depuis le cache sans consommer de crédits. Confirmé par l’en‑tête X-Cache: HIT.

Peut‑on acheter des crédits sans abonnement ?

Pas encore. L’abonnement donne un budget prévisible et un meilleur rate limit. Un plan pay‑as‑you‑go est prévu.

Technique

Quels SDK sont disponibles ?

• MCP serveur ✅ réalisé : npx -y @astroway/mcp : expose tous les 771+ endpoints comme outils pour Claude Desktop, Cursor, GPT et d’autres agents IA compatibles MCP
• TypeScript SDK ✅ réalisé : npm install @astroway/sdk : types + autocomplete depuis OpenAPI 3.1, retry + idempotency, erreurs style Stainless
• Python SDK ✅ réalisé : pip install astroway : sync Astroway + async AsyncAstroway, basé sur httpx, typé PEP 561
• PHP SDK ✅ réalisé : composer require astroway/sdk : PHP 8.1+, Guzzle 7 + PSR‑18, middleware de retry
• Go / Ruby / Rust 📋 prévu : abonne‑toi aux notifications par email sur la page de chaque SDK (/sdk/<language>/)

Le contrat API – REST standard + JSON, donc n’importe quel client HTTP fonctionne sans SDK. La collection Postman et la spécification OpenAPI 3.1 sont disponibles publiquement.

Y a-t-il un mode sandbox ?

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

Quel est le rate limit ?

Cela dépend du plan : Free – 10, Indie – 30, Starter – 120, Pro – 400, Business – 1 000 req/min. En cas de dépassement – 429 avec l’en‑tête Retry-After.

Le zodiaque sidéral est‑il supporté ?

Oui. Envoie "zodiacType": "sidereal" et éventuellement "ayanamsaId" (par défaut – Lahiri). 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 incarnée, canaux, centres, Dream Rave, Hologenetic Profile, Penta (dynamique de groupe), sensibilité temporelle. La couverture HD la plus approfondie parmi les API commerciales.

Sécurité et confidentialité

Les données des requêtes sont‑elles conservées ?

L’API fonctionne stateless – les données de date/heure/coordonnées de naissance ne sont pas conservées après le traitement de la requête. Seules les métadonnées sont journalisées : key_id, endpoint, timestamp, latency, crédits. Aucun donnée personnelle.

L’API répond‑elle aux exigences du GDPR ?

Oui. Les données ne sont pas stockées. Pour les utilisateurs de l’UE : aucune traitement de PII, aucun profilage, aucun cookie. La clé API est liée au compte, pas à l’utilisateur final.

Les interprétations IA sont‑elles sûres ?

Les AI‑endpoints (/interpret/*, /horoscope/*) intègrent des garde‑fous de sécurité : interdiction de conseils médicaux, juridiques ou financiers. Chaque réponse inclut un disclaimer. Traçabilité complète – pour la conformité enterprise.

Support

Comment obtenir de l’aide ?

Cela dépend du plan : Free – communauté, Indie – email (48 h), Starter – email (24 h), Pro – email (4 h), Business – email + Slack (1 h), Enterprise – manager dédié sur Slack. Contacts – sur la page Contact.

Y a-t-il un SLA ?

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

Noms similaires

L’API AstroWay (astroway.info) est‑elle liée à l’abonnement ” Astroway ” de astroway.life ?

Non. astroway.info et api.astroway.info sont une société distincte et indépendante. Nous fournissons une API astrologique pour les développeurs (api.astroway.info), une application pour les utilisateurs finaux (app.astroway.info) et des consultations d’astrologue. Nous n’avons aucun lien avec l’abonnement astrologique grand public promu et facturé sous le nom ” Astroway ” via astroway.life (emails de no-reply@astroway.life, personnage ” Celeste ”, sur le relevé bancaire – ” Astroway ”). L’opérateur de cet abonnement est TrafficLeader OÜ (Estonie, aussi traffic-leader.com) ; le facturier associé SKYREAD.PRO est ABCMobile OÜ (Estonie). Seule la ressemblance du nom est similaire – ce sont des entreprises différentes.

” Astroway ” me débite – comment annuler l’abonnement et obtenir un remboursement ?

Si tu es débité pour l’abonnement ” Astroway ” (emails de no-reply@astroway.life, sur le relevé bancaire – ” Astroway ”), il s’agit d’une autre société, astroway.life, pas de nous. Nous n’avons aucun accès à ton compte ou aux paiements de ce service, donc nous ne pouvons pas les annuler ni rembourser. Voici la marche à suivre :

1. Réponds directement à l’email de no-reply@astroway.life et utilise le lien ” se désabonner / annuler ” dans son pied de page.
2. Si aucune réponse : contacte ta banque ou l’émetteur de ta carte (paiement sur le relevé – ” Astroway ” ; marchand – TrafficLeader OÜ ou ABCMobile OÜ / SKYREAD.PRO, Estonie) et demande de bloquer les futurs prélèvements ou d’initier un remboursement (chargeback).