How we build the API.
Internals, postmortems, and design decisions. Everything we wish someone had written down before we had to figure it out the hard way.
Numérologie dans l'API: 5 systèmes de calcul par un seul endpoint
La plupart des API n'ont pas de numérologie ou ne proposent qu'un seul système pythagoricien. Nous avons 5 systèmes complets (pythagoricien, chaldéen, deux kabbalistiques, védique) avec 10 calculs chacun, via un seul endpoint paramétré. Plus la Matrice du Destin avec 22 arcanes.
Carte du catalogue : comment sont organisés 700+ endpoints AstroWay
L'API a atteint plus de 700 endpoints répartis en 57 groupes – de la carte natale à BaZi, la géomancie et le rendu de cartes SVG. Nous détaillons comment le catalogue est divisé en domaines, le seul pattern suivi par tous les calls, et comment trouver rapidement l'endpoint requis.
Trois SDK officiels : TypeScript, Python, PHP au lieu de curl brut
Le HTTP brut fonctionne, mais un client typé fait gagner des heures : autocomplétion des chemins, types de requête et de réponse, retry intégré sur 408/409/429/5xx et hiérarchie d'erreurs à la Stainless. Tour d'horizon des trois SDK officiels, @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist), et de la manière dont ils sont générés à partir d'un même contrat OpenAPI.
Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
Natal Chart API in PHP: SDK + Laravel Example
Compute a natal chart in PHP with the AstroWay SDK - plain PHP and a Laravel facade - without compiling a Swiss Ephemeris extension.
Natal Chart API in Python: 3 Examples with the AstroWay SDK
How to compute a natal chart in Python via API - install, first request, transits and synastry - with working code and how it compares to pyswisseph and kerykeion.
Natal Chart API in TypeScript: SDK + React Example
Compute a natal chart in TypeScript with the AstroWay SDK - typed responses, a React component, and where it beats a local ephemeris library.
X-Cache header : cache-status visible pour l'optimisation des intégrations client
Chaque réponse API porte désormais X-Cache: MISS | HIT | BYPASS - le client voit immédiatement si la requête a été calculée à partir de zéro ou récupérée du cache. Cela ouvre la colonne cache hit % dans /dashboard/usage et permet d'optimiser l'intégration sans guesswork.
Reports V2: un endpoint au lieu de douze - `/v1/reports/generate`
Au lieu de 12 routes type‑specific /reports/natal, /reports/synastry, … - un endpoint unifié POST /v1/reports/generate avec le champ report_type. Les consommateurs SDK obtiennent une méthode unique au lieu de douze ; le catalogue MCP passe de 12 outils à un seul.
L'astrologie védique via API : de Parashara au Lal Kitab en 354 endpoints
AstroWay offre désormais la couverture védique la plus complète parmi les API commerciales : 10 systèmes de dashas, 16 vargas, Panchang, Lal Kitab complet + KP + Jaimini. Comment ça fonctionne et quelle technique choisir selon le cas.
White-label PDF sans WordPress : inline branding via un seul champ
Le champ whitelabel dans les schémas des 12 endpoints /v1/reports/* accepte désormais non seulement un boolean (voir config DB), mais aussi un objet inline avec 15 champs. Cela supprime la dépendance à l'utilisateur WordPress – tout consommateur SaaS de l'API peut brander le PDF à la volée, sans page admin séparée.
Construire une application d'astrologie : guide complet pour les développeurs
Guide étape par étape pour créer une application d'astrologie à partir de zéro - choix de l'API, architecture, première carte natale, ajout de synastrie et de transits, déploiement.
Démarrage rapide de l'API d'astrologie : TypeScript et Python en 5 minutes
Installer le SDK, obtenir une clé API, effectuer une requête de carte natale. 5 minutes - et un JSON fonctionnel en main (TypeScript et Python).
API de rectification : correction de l'heure de naissance pour les développeurs
La rectification est le processus de correction d'une heure de naissance inconnue ou imprécise en fonction des événements de la vie. Dans cet article, comment l'automatiser via l'API en utilisant la méthode algorithmique et la Trutine d'Hermès.
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.