Notes d'ingénierie.
À propos de la précision des éphémérides, de l'architecture de calcul, du protocole MCP et de tous les petits détails qui ne rentrent pas dans la documentation.
Documentation conçue pour les agents IA, et pas seulement pour les humains
La documentation classique est conçue pour les yeux humains : beau HTML, coloration syntaxique, navigation. Mais la moitié du trafic vers les docs maintenant vient d'agents et d'assistants qui ont besoin de texte brut, pas de rendu. Nous expliquons ce que nous avons ajouté : un double .md pour chaque page, llms.txt, spécifications lisibles par machine, menu déroulant 'ouvrir dans ChatGPT / Claude' et essai en ligne.
Lire →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.
Lire →Sortie MCP typée : pourquoi 600+ outils ont un outputSchema
La plupart des serveurs MCP renvoient un JSON non typé à l'agent - le modèle doit deviner la forme de la réponse. Nous publions un outputSchema strict pour 600+ outils. Nous expliquons comment cela fonctionne, quel bug cela a ouvert chez les clients en mode strict et comment nous l'avons corrigé via des schémas ouverts.
Lire →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.
Lire →Comment nous gardons la précision sous contrôle : la CI contre swetest et la NASA
Dans une API d'astrologie, la précision se dégrade facilement après un seul refactoring des éphémérides. Voici notre protection : un seul noyau Swiss Ephemeris pour l'application et l'API, des centaines de snapshots figés sur des thèmes de référence et la triangulation de chaque PR contre swetest CGI, Kerykeion, Prokerala et le catalogue d'éclipses de la NASA.
Lire →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.
Lire →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
Lire →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.
Lire →