Le catalogue AstroWay compte déjà 758 endpoints répartis en 57 groupes. À cette échelle, la question principale de l’intégrateur n’est pas «est‑ce que la couverture suffit», mais «comment ne pas se perdre». Cet article est une carte : comment le catalogue est divisé en domaines et comment trouver ce qu’il faut en une minute.
Un seul pattern pour tous les appels
Section intitulée « Un seul pattern pour tous les appels »Indépendamment du domaine, chaque endpoint de calcul a la même forme :
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonLe corps – du JSON avec les données de naissance (date, heure, coordonnées) ou des paramètres spécifiques à la technique. La réponse – toujours { "ok": true, "data": {...} } ou { "ok": false, "error": {...} }. Aucun GraphQL, aucun auth‑flow séparé par domaine : une clé dans l’en‑tête X-Api-Key, un format de réponse.
Cela signifie que le wrapper que tu écris pour la carte natale convient aussi pour BaZi et pour les runes – seul le chemin et le schéma du corps changent.
Domaines du catalogue
Section intitulée « Domaines du catalogue »Le catalogue est regroupé en grands domaines. Voici une carte avec les compteurs réels (les nombres proviennent du manifeste sur chaque build, donc ils sont toujours à jour ici) :
| Domaine | Endpoints | Contenu |
|---|---|---|
| Astrologie occidentale | 182 | Carte natale, aspects, dignités, progénostique (transits, progressions, directions), horary, 4 écoles ellinistiques, psychologie moderne, évolutionnaire, cosmobiologie |
| Védique | 174 | Le plus grand domaine : nakshatras, dashas, cartes divisionnelles (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodygraph, canaux, portes, type/profil/autorité, croix incarnée |
| Tarot | 66 | Trois jeux : Rider‑Waite‑Smith, Marseille, Lenormand – tirages, significations, combinaisons |
| Numérologie | 50 | 5 systèmes de 10 calculs chacun (pythagoricien, chaldéen, deux kabalistiques, védique) |
| Chinoise + Maya | 55 | BaZi (quatre piliers), Zi Wei Dou Shu, zodiaque chinois et feng‑shui, calendriers Maya |
| Divination | 31 | Géomancie (Agrippa), runes du Grand Futark, chiromancie (Cheiro), I Ching |
| Niches appliquées | 51 | Wellness, astrologie animale, business, finances, familiale |
| Rapports | 23 | Interprétations prêtes (natal, synastrie), en HTML/PDF, avec branding en marque blanche |
| Rendu | 14 | Roues de cartes SVG/PNG, bodygraph, anneaux de transit – sans front‑end propre |
| Outils dev | 44 | Webhooks, streaming en temps réel, widgets intégrés, white‑label |
Le reste – interprétations IA, horoscopes, endpoints de référence (signes, planètes, aspects) et systèmes (health, usage, openapi).
Védique – une histoire à part
Section intitulée « Védique – une histoire à part »174 endpoints védiques – c’est plus que toute la partie occidentale. La raison est simple : la tradition védique est plus formalisée. Là où l’astrologie occidentale a un seul ensemble de maisons, le védique possède 16 cartes divisionnelles (varga), plusieurs systèmes de dasha, des dizaines de yogas avec des règles précises. Chacun de ces éléments est un endpoint distinct avec un résultat déterminé.
Si tu construis pour le marché indien, c’est le cœur du produit, pas un ajout.
Précision sous tout ça
Section intitulée « Précision sous tout ça »Indépendamment de l’exotisme de la technique, les positions planétaires sont calculées par un même noyau sur Swiss Ephemeris (WASM). Le même noyau fonctionne à la fois dans le navigateur de notre application et sur le serveur API – une base de code unique, aucune divergence. Les endpoints de calcul sont couverts par 873 tests snapshot, qui à chaque PR sont comparés aux sources de référence. Plus de détails dans un article dédié à la précision CI.
Comment trouver ce qu’il faut
Section intitulée « Comment trouver ce qu’il faut »Trois voies, de la plus rapide :
- Guide OpenAPI – /docs/api/ est généré directement à partir de la spécification prod
openapi.json. Les groupes dans la barre latérale = les domaines ci‑dessus. Chaque endpoint possède un schéma de corps, un exemple et un bouton «essayer». - Catalogue MCP – si tu es sur Claude ou Cursor, tout le catalogue est disponible comme un ensemble d’outils via
mcp.astroway.info. L’agent trouve lui‑même l’endpoint requis à partir de la description. - Recherche par spécification –
curl https://api.astroway.info/v1/openapi.jsonrenvoie le contrat complet lisible par machine. Pratique pour la génération de code d’un client propre.
Commencer
Section intitulée « Commencer »La clé sur dashboard/sign-up donne 10 000 crédits par mois – suffisant pour parcourir des dizaines de domaines et comprendre ce qui t’intéresse. Pas besoin d’étudier le catalogue en entier : prends ton domaine, le reste attendra quand il sera nécessaire.
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.