Changelog what is new

Toutes les modifications qui affectent le code de l’intégrateur : nouveaux points de terminaison, mises à jour du SDK, modifications dans /openapi.json, corrections de prix dans les crédits, obsolescence, modifications cassantes. Les plus récentes en haut. Les modifications internes du site ne sont pas enregistrées ici.

Le contrat API est stable dans /v1/* - toute modification cassante sort sous /v2/*, et /v1/* continue de fonctionner pendant au moins 12 mois.

2026-05-16 — Point de terminaison MCP hébergé en direct à mcp.astroway.info/mcp

@astroway/mcp est maintenant disponible en deux modes de transport. Stdio (paquet npm) reste inchangé ; un point de terminaison HTTP hébergé a été ajouté pour une intégration zero-install dans Claude $1 (claude.ai dans le navigateur), Claude $1, Cursor, Cline et d’autres clients compatibles MCP.

Installation en un clic pour Cursor - bouton cursor://anysphere.cursor-deeplink/mcp/install?... sur la page /examples/mcp/. Claude $1 - via + → Add Connector → Custom (sans édition JSON).

// Équivalent JSON pour Cline / Continue / Windsurf
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Même catalogue de 630 outils + 12 invites + 14 ressources, même aw_test_* / aw_live_* d’authentification (dans le mode hébergé via l’en-tête Authorization: Bearer … au lieu de la variable d’environnement), même piscine de crédits. Conçu pour être multi-locataire - chaque demande porte sa propre clé, les crédits sont débités du compte du propriétaire de la clé. Canal dans X-Astroway-Channel - mcp-http (hébergé) vs mcp (stdio) pour le suivi de l’adoption.

Pourquoi deux modes. Stdio (npx @astroway/mcp) reste pour les utilisateurs avancés de Cursor / les intégrateurs soucieux de la vie privée - la clé ne quitte jamais la machine, sans sauts réseau. Hébergé répond au segment Claude $1 (qui prend uniquement en charge les MCP distants) et aux scénarios d’installation zéro.

Point de terminaison de santé - accessible publiquement sans authentification :

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"2024-11-05"}

Documentation complète des deux modes - /examples/mcp/.

2026-05-15 — Nouveau point de terminaison GET /v1/auth/keys/me

Introspection de la clé API. Vous passez X-Api-Key - vous obtenez l’état complet : plan, crédits, statut, domaine lié, heure de création, source d’enregistrement. Utile pour les consommateurs de SDK (TS / Python / PHP / MCP) - “ce que j’ai comme clé actuellement” sans lire le tableau de bord. Analogue Stripe /v1/account ou GitHub /user.

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # premiers 11 caractères, clé complète jamais renvoyée
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # fin calendrier du mois
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # domaine auquel la clé est liée (wp-plugin clés)
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

Sans auth : 401 MISSING_API_KEY. Clé non valide : 401 INVALID_API_KEY.

Spécification OpenAPI 3.1. /v1/openapi.json déclare maintenant /v1/auth/keys/me. La génération de code SDK (openapi-typescript, openapi-generator-cli) écrira automatiquement client.auth.keys.me() lors de la prochaine régénération.

Rétrocompatibilité. L’ancien GET /v1/keys/usage (qui renvoyait uniquement credits_today + ratelimit) continue de fonctionner - c’est un point de terminaison distinct pour les vérifications serveur cron. /auth/keys/me renvoie l’état complet plus le lien de domaine pour les scénarios wp-plugin.

2026-05-14 — Localisation /horoscope/* et /interpret/* (21 langues)

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility} et POST /v1/interpret/{natal,synastry,transits,element,placement} - 10 points de terminaison qui renvoient le texte d’interprétation - maintenant renvoient la réponse dans la langue du client.

Comment activer :

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Accept-Language: hi" \
  -H "Content-Type: application/json" \
  -d '{"sign": "leo"}'
# → réponse en हिन्दी

Priorité de résolution (côté serveur) :

1. body.language="de" - paramètre explicite par appel (priorité la plus élevée)
2. Accept-Language: de, en;q=0.7 - poids q de la RFC 7231 ; le premier code qui correspond à la langue active gagne
3. ?lang=de - paramètre de requête pour les clients qui ne contrôlent pas les en-têtes
4. Valeur par défaut → uk (langue source)

Langues prises en charge (21) : uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id. Les codes inconnus tombent silencieusement dans uk sans erreur.

Spécification OpenAPI 3.1. /v1/openapi.json déclare maintenant Accept-Language (en-tête) et lang (paramètre de requête) comme paramètres avec énumération de 21 codes sur ces 10 points de terminaison. La génération de code SDK (openapi-typescript, openapi-generator-cli) écrira automatiquement des appels typés .lang('hi') lors de la prochaine régénération.

Ce qui est traduit : uniquement les champs de texte d’interprétation (horoscope, interpretation, disclaimer, etc.). Les champs numériques (longitude, latitude, score, ID de signes, ID de maisons) restent canoniques - le client les formate localement. Norme de segment (Vedika, DivineAPI, AstrologyAPI.com).

Portée : pour l’instant, les 10 points de terminaison du groupe d’interprétation sont localisés. Les points de terminaison de calcul (/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690 autres) renvoient des nombres et des identificateurs canoniques (name: "Aries", glyph: "♈") inchangés - le client les localise via ses propres tables de correspondance. C’est la norme de segment.

Rétrocompatibilité. Le code existant sans Accept-Language / ?lang= / body.language reçoit uk par défaut, comme avant.

La prise en charge du SDK (@astroway/sdk, astroway, astroway/sdk, @astroway/mcp) ajoute l’option lang dans le constructeur - des versions distinctes arrivent dans les semaines à venir via cron-applier sur les référentiels de staging.

2026-05-09 — Trois SDK lancés : TypeScript, Python, PHP

Trois SDK officiels vivent sur les référentiels publics - des enveloppes autour des mêmes 700+ points de terminaison de l’API. Une spécification OpenAPI 3.1 → trois clients d’idiome de langage.

Ce que cela signifie pour l’intégrateur :

• Alternative typée aux appels HTTP bruts. Autocomplétion de chemin + types de requêtes et de réponses dans l’IDE. Méthodes d’aide aw.post('/chart', body=...) (Python/PHP) ou aw.client.POST('/chart', { body }) (TS) - au lieu d’un fetch / requests / Guzzle manuel.
• Surface identique entre les langages. Constructeur Astroway({apiKey, baseUrl, authScheme, timeout, retry}) fonctionne de la même manière dans TS / Python / PHP. Si votre projet est multilingue - moins de surcharge cognitive.
• Réessai intégré sur 408/409/429/5xx avec backoff exponentiel + jitter complet. Respecte l’en-tête Retry-After. Défaut 2 réessais, configurable via retry={maxRetries: 0}.
• Hiérarchie d’erreurs inoxydable - le même modèle que dans les SDK Stripe / OpenAI / Cloudflare. Attrapez RateLimitError (avec retryAfterSeconds), AuthenticationError (faites pivoter la clé), BadRequestError (validation), ApiError (générique) - dans cet ordre.
• Deux schémas d’authentification. Par défaut X-Api-Key: aw_live_... (comme dans curl/Postman). Ou Authorization: Bearer aw_live_... (comme dans les SDK Stripe/OpenAI/Anthropic) - auth_scheme="bearer" dans le constructeur.
• En-têtes d’identification, pas de télémétrie. Chaque appel porte User-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>. Aucun phone-home, aucun commutateur opt-in/opt-out.
• OIDC + SLSA L3 provenance (TS + Python). Enregistrement attesté par Sigstore que le package est construit à partir d’un commit spécifique dans le référentiel public. Sans jetons à long terme dans le CI.
• MIT, code source complet ouvert sur github.com/astroway/{astroway-typescript,astroway-python,astroway-php}.

Démarrage rapide :

// TypeScript / Node 20+
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data } = await aw.client.POST('/chart', { body: { date: '1990-07-14', /* ... */ } });

# Python 3.9+
from astroway import Astroway
aw = Astroway(api_key=os.environ['ASTROWAY_API_KEY'])
chart = aw.post('/chart', body={'date': '1990-07-14', ...})

// PHP 8.1+
use Astroway\Astroway;
$aw = new Astroway(['apiKey' => getenv('ASTROWAY_API_KEY')]);
$chart = $aw->post('/chart', body: ['date' => '1990-07-14', /* ... */]);

Variante asynchrone pour Python - AsyncAstroway avec surface identique via async/await. En PHP - synchrone uniquement (PHP n’a pas d’histoire asynchrone unifiée). En TS - promesses natives basées sur openapi-fetch.

Ceci est alpha - l’API publique peut changer jusqu’à 0.1.0 correct lors de la rétroaction des intégrateurs. Fixez la version exacte (@astroway/sdk@0.1.0-alpha.1) pendant la fenêtre alpha - ou le dernier alpha au moment de l’installation.

@astroway/mcp - serveur MCP pour Claude / Cursor / GPT - continue de vivre à côté comme produit distinct.

2026-05-07 — Mise à jour du serveur MCP

@astroway/mcp a été mis à jour - auto-génère le catalogue d’outils à partir du /openapi.json actuel sans édition manuelle. Tout ce qui est apparu dans l’API au cours des dernières semaines (suite de compatibilité, points de terminaison de rapports) est immédiatement visible dans Claude / Cursor / GPT.

Pour l’intégrateur :

• Le catalogue d’outils reflète l’état actuel de l’API
• Les points de terminaison de modèle de chemin (/v1/.../id) sont ignorés pour l’instant, afin de ne pas embrouiller le parseur de description
• Les annotations de coût dans la description de l’outil - Claude voit le coût de l’appel avant l’exécution
• OIDC trusted publishing + SLSA L3 provenance - le package est attesté jusqu’à un commit spécifique dans le référentiel public astroway/astroway-mcp

Installation :

npm install -g @astroway/mcp

Ou via la configuration MCP de Claude $1 / Cursor :

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"]
    }
  }
}

Source : référentiel public astroway/astroway-mcp (MIT).

2026-04-11 — Compatibilité inter-systèmes (+10 points de terminaison)

Nouveau groupe /v1/compat/* - score de compatibilité composite à travers les systèmes occidentaux, védiques, chinois, numériques, tarot, design humain. 6 systèmes fournissent une métrique unifiée pour les indicateurs UX dans les applications astrologiques multitraditionnelles.

Chaque point de terminaison renvoie un JSON avec un champ disclaimer - c’est la méthodologie de notation AstroWay, pas d’affirmation clinique ou juridique. Niveau 4 (100 crédits) par appel - calcul lourd de compatibilité inter-systèmes.

Manifeste sur /openapi.json mis à jour - SDK / MCP prendront en charge automatiquement.

2026-03-28 — Rapports + Webhooks (+17 points de terminaison)

Deux nouveaux groupes en production.

/v1/reports/* (12 points de terminaison) - génération de rapports HTML / PDF via Puppeteer. Rendu sur le côté de l’API, URL de téléchargement signée (TTL 24h).

/v1/webhooks/* (5 points de terminaison) - gestion d’abonnement, livraison d’événements, signature HMAC. Abonnement aux événements credits.low, key.created, usage.threshold, error.spike.

curl -X POST https://api.astroway.info/v1/webhooks \
  -H "Authorization: Bearer aw_live_..." \
  -d '{"url": "https://...", "events": ["credits.low"], "secret": "wh_secret_..."}'

Chaque livraison porte X-Astroway-Signature: sha256=<hmac> - vérifiez via secret. Politique de réessai : backoff exponentiel sur 5xx, jusqu’à 5 tentatives dans les 24 heures.

2026-03-14 — Points de terminaison de référence : public, sans clé, sans crédits

14 points de terminaison /v1/reference/* (signes, planètes, maisons, aspects, éléments, modalités, polarités, dignités, décans, nakshatras, lots, astéroïdes, systèmes zodiacaux, glyphes) fonctionnent maintenant sans X-Api-Key et coûtent 0 crédits. Ce sont des tables de correspondance canoniques - les facturer via la facturation était une erreur de conception.

Ce que cela signifie pour l’intégrateur :

• Appel sans clé - les agents MCP externes / SDK / pages d’aperçu peuvent extraire des données de référence sans authentification. La limitation de débit IP (comme sur /public) reste à 30 appels / heure.
• Manifeste de coût mis à jour - 14 chemins sont passés de TIER_HALF (5 crédits) à 0. Si votre planificateur de budget astroway_cost_estimate fait référence à ces chemins - les nouveaux appels n’affectent pas la quote-part.
• Clients existants avec clé fonctionnent sans changement. X-Api-Key est ignoré pour /reference/* (nous n’insistons pas sur l’en-tête superflu).

Rétrocompatibilité : les réponses 200 et le schéma JSON ne changent pas, seule la exigence d’authentification est supprimée.

2026-03-07 — Offre à vie des fondateurs : 299 $ → tarif Indie à vie

Lancement de l’offre à vie des fondateurs - lancement limité. Les 100 premiers clients paient 299 $ une fois et reçoivent le tarif Indie (50 000 crédits/mois) à vie, sans débits récurrents, avec un prix fixe.

Ce que cela signifie pour les intégrateurs :

• Tarif standard Indie = 5 $/mois. Offre à vie des fondateurs = 299 $ une fois → point de récupération à la 5e année, puis retour sur investissement illimité. Si votre projet dure au moins 5 ans en astrologie / numéologie / tarot - l’offre à vie des fondateurs est rentable.
• Charge utile Webhook sur commande SKU astroway-api-indie-lifetime : chaîne api_keys reçoit plan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULL. Aucun débit mensuel, aucun webhook de renouvellement.
• Schéma de base de données : colonnes ajoutées is_lifetime TINYINT(1) dans api_keys et shared_user_quotas. Type TS ApiKeyInfo étendu. Les clés existantes = is_lifetime=0 (sans changement de comportement).
• Point de terminaison REST WP GET /wp-json/astroway/v1/founders-count renvoie {sold, total: 100, remaining, available} - utilisé dans le composant site/components/founders/FoundersCounter.astro pour le compteur en temps réel sur la page /founders/.
• Désactivation automatique à 100/100 : statut de produit WC _stock_status passe automatiquement en outofstock via le crochet WC woocommerce_order_status_completed. Après cela, le lien de commande redirige vers /pricing/#indie (tarif Indie standard 5 $/mois).

Pages en direct : /founders/ (uk) + /en/founders/ (en). Entrée de barre latérale “Offre à vie des fondateurs” avec badge 100 seuls.

Produit WC : astroway-api-indie-lifetime, ID 30618, 299 $ (13225 UAH), stock = 100. Commande : astroway.info/checkout/?add-to-cart=30618.

2026-03-05 — Page d’atterrissage GDPR / résidence UE + badge Pro UE

Lancement de /eu/ - page distincte pour les développeurs UE dont le produit est sensible au GDPR. L’intégrateur doit savoir :

• Pro 59 $ = résidence UE par défaut (Hetzner Nuremberg, flux de données uniquement dans l’UE, analyse anonyme - Plausible cookie-free dans la feuille de route).
• DPA standard disponible non seulement sur Enterprise - signé via e-mail sur le tarif Pro dans les 5 jours ouvrables.
• DELETE /v1/me/account - point de terminaison pour le droit à l’oubli du GDPR (supprime immédiatement votre wp_user_id de toutes les tables).
• Carte Pro sur /pricing/ a maintenant un badge 🇪🇺 GDPR-prêt - clic conduit à /eu/ avec FAQ complet.
• DivineAPI / AstrologyAPI / Prokerala - hébergement US/Inde, DPA uniquement sur Enterprise. Si la conformité au GDPR est critique - Pro 59 $ est le moyen le moins cher.

Pages : /eu/ (uk) + /en/eu/ (en). Entrée dans la navigation latérale « Conformité au GDPR / résidence UE » avec badge 🇪🇺.

2026-03-03 — Prépaiement annuel -25 % + transfert de crédits + fonctionnalités Pro publiques

Deux changements qui affectent le code des intégrateurs :

• Réduction annuelle 17 % → 25 % (3 mois gratuits au lieu de 2). Nouveaux prix USD par an : Indie 45 $, Starter 171 $, Pro 531 $, Business 1791 $, Pack HD/Esotérique 81 $, Pack Védique 171 $, Pack Rapports 891 $. Les abonnés annuels existants ne sont pas affectés - le nouveau prix s’applique uniquement aux futures reconductions d’abonnement. Si vous avez analysé les prix USD via /wp-json/astroway/v1/api-prices - les valeurs mises à jour sont maintenant renvoyées automatiquement.
• Transfert de crédits pour les abonnés annuels : les crédits non utilisés sont reportés au prochain cycle mensuel, limités à 1 × la limite mensuelle du forfait. Activé automatiquement lors de la souscription d’un forfait annuel. Visible via les nouveaux en-têtes de réponse :
  • X-Credits-Limit: <int> - limite mensuelle effective (inclut le report)
  • X-Credits-Remaining: <int> - comme avant, mais en tenant compte du report
  • X-Credits-Rollover: <int> - solde actuel de crédits reportés (uniquement pour les annuels)

Schéma de base de données : colonnes ajoutées credit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED dans api_keys et shared_user_quotas. Au début - les deux = 0 pour toutes les clés existantes.

2026-03-01 — Tableau de coûts transparent des crédits par point de terminaison

Lancement de la page publique /credits/ avec la ventilation complète des crédits pour les 700+ points de terminaison. Aucun concurrent (DivineAPI, AstrologyAPI, Prokerala) ne publie un tel tableau - ils facturent un crédit fixe par appel et cachent la routage interne.

Pour l’intégrateur, cela donne trois choses :

• Unité économique transparente - coût précis $/appel pour chaque point de terminaison (tarifs mensuels /pricing/ × coût du forfait = coût réel par appel).
• Synchronisation automatique avec le code - le tableau est généré lors de la construction à partir de endpoint-costs.ts. Si nous ajoutons un nouveau point de terminaison ou modifions le forfait - la page est mise à jour automatiquement lors du prochain déploiement.
• Marqueur de forfait gratuit - colonne indiquant quels points de terminaison nécessitent Indie+ (symbole 🔒, 28 points de terminaison actuellement).

Disponible : /credits/ (uk) et /en/credits/ (en). Liens croisés avec /rate-limits-credits/ et entrée dans la navigation latérale Starlight (symbole « Nouveau »).

2026-02-27 — Vedic-charts, cosmogram, eclipse-path, star-map (+6 points de terminaison)

Fermeture de la catégorie Visualisation sur 14/14 points de terminaison selon la feuille de route :

• POST /v1/render/wheel-vedic-north - disposition nord-indienne (losange).
• POST /v1/render/wheel-vedic-south - disposition sud-indienne (4 × 4 grille).
• POST /v1/render/wheel-vedic-east - disposition est-indienne (Bengali). Carré avec diagonales + carré interne tourné.
• POST /v1/render/cosmogram - école de Hambourg / Cosmobiologie 90°-dial (Ebertin 1940 + Witte 1928).
• POST /v1/render/eclipse-path - carte du monde équirectangulaire avec le chemin lat/lon fourni par l’appelant ; rend les lignes centrales + bandes de largeur spécifiée.
• POST /v1/render/star-map - projection stéréographique de la liste de points (RA/Dec) avec mise à l’échelle de magnitude.

Tous les rendus sont des SVG purs, sans headless-Chrome.

2026-02-25 — Bi-/tri-roue + composite + biorhythm (+4 points de terminaison)

Quatre nouveaux points de terminaison de visualiseur qui étendent la mécanique SVG :

• POST /v1/render/bi-wheel - deux cercles concentriques : interne natif + cercle externe avec des planètes de transit (ou progressées).
• POST /v1/render/tri-wheel - trois cercles : natif + progressé + transit.
• POST /v1/render/composite - rend la carte composite à partir de deux données de naissance (midpoint composite).
• POST /v1/render/biorhythm - graphique sinusoïdal des trois cycles : physique (23 jours), émotionnel (28), intellectuel (33).

Calculs ici même, uniquement le rendu ; pour bi-roue tous les calculs de planètes des deux cartes sont effectués en parallèle (Promise.all).

2026-02-24 — Visualisation : rendu SVG (+4 points de terminaison)

Quatre nouveaux points de terminaison qui renvoient des rendus SVG de cartes natales et de visualiseurs associés. Pur serveur - sans Puppeteer/headless-Chrome, donc latence ~10 ms au lieu de 1-2 s et gratuit pour le forfait gratuit.

• POST /v1/render/wheel-western - roue occidentale (anneau de signes + anneau de maisons + planètes + lignes d’aspect).
• POST /v1/render/aspect-grid - matrice triangulaire d’aspects avec signe + orbe dans les cellules.
• POST /v1/render/moon-phase - disque lunaire avec éclairage ; renvoie SVG plus illuminationFraction, phase, waxing.
• POST /v1/render/timeline - style Gantt pour les événements de transit sur une période (appelant fournit un tableau events).

Options : size, theme (light / dark / console), format (json renvoie { svg, byteLength }, svg renvoie image/svg+xml directement). Niveau de base - 2 crédits par appel.

2026-02-23 — Schémas typés dans /v1/openapi.json (612 points de terminaison, 98 %)

/v1/openapi.json est maintenant une spécification lisible par machine complète et pour corps de requête, et pour données de réponse. Typés 612 des 624 points de terminaison POST via trois étapes consécutives qui ont atterri ensemble :

• Corps de requête - 386 points de terminaison typés via components.schemas (128 composants réutilisables). Parmi eux 5 partagés (ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper) et 123 locaux (DashaInput, MuhuratWindow, ChartWithTnp, WheelWestern, etc.). Composition via allOf pour l’héritage (DashaInput extends ChartInput).
• Données de réponse - 612 points de terminaison typés via un inférenceur qui parcourt les exemples de réponse dans le manifeste : {type: 'object', properties: {...}} au lieu de {type: 'object'} plat. La carte natale déclare maintenant data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[] avec des types de champs réels.
• Reste de 12 points de terminaison - dasha pratyantar/sookshma avec des exemples de raccourci non discriminés dans le manifeste - restent {type: object}. Rétrocompatibilité, les ajoutons dans les prochaines versions.

Ce que cela signifie pour l’intégrateur :

• Régénérez le client OpenAPI - openapi-typescript, openapi-fetch, swagger-codegen créeront des interfaces avec des champs typés au lieu de Record<string, unknown>. L’autocomplétion sur les corps de requête + les données de réponse data fonctionne de manière native.
• La collection Postman sur /postman/astroway-api.json a été mise à jour avec les mêmes types - importez-la, obtenez l’autocomplétion pour tous les points de terminaison typés.

Rétrocompatibilité : la forme précédente {"type": "object"} était permissive - tous les clients existants continuent de fonctionner sans changement.

2026-02-21 — Rééquilibrage des plans de crédits : 5 niveaux + Forfait gratuit 5K → 10K

Rééquilibrage des niveaux de crédits après un audit de 18 concurrents. Le forfait gratuit donne maintenant 10 000 crédits par mois (contre 5 000). Les pourcentages de dépenses pour les cas d’utilisation typiques (carte natale + 7 transits) sont réduits de ~22 %. Aucun changement cassant dans l’API - uniquement l’économie.

2026-02-17 — Jaimini analyse suite (+10 points de terminaison)

Dix points de terminaison d’analyse Jaimini - chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK dans D9), résumé de dasha en cours, yogas Jaimini de base.

Sources : Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-02-15 — Kros-école : Jaimini yogas + Lal Kitab et KP doshas (+17 points de terminaison)

Dix-sept points de terminaison - ferment la verticale kros-école pour les yogas et les doshas.

• Jaimini Yogas (5) - /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}. Basés sur les chara karakas (AK / Amk / PK).
• Lal Kitab dosha variantes (6) - /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}. Variations Lal Kitab spécifiques et upayas.
• KP dosha variantes (6) - /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}. Règles BPHS + chaîne de sous-seigneurs KP. Sade Sati - transit-aware (nécessite targetDate).

Sources : Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI.

2026-02-13 — Forfait Védique ($19 / 100 000 crédits)

Forfait distinct pour l’astrologie védique - 165 points de terminaison pour le prix du forfait Starter :

• Forfait vedic_pack (19 $/mois ou 190 $/an) donne 100 000 crédits et 100 appels/minute.
• Accès limité aux espaces de noms védiques (/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional). Tous les autres points de terminaison renvoient 402 PLAN_PACK_MISMATCH.
• Couverture : 16 vargas D1-D60, panchang (7), shadbala (7), yogas (7), doshas (7), compatibilité ashtakoot (6), muhurat (12 catégories), 8 systèmes dasha × 5 niveaux (40), KP, Lal Kitab, Jaimini.
• 2,5-5 × plus de cartes pour le même prix que Prokerala Ruby (~5K kundlis/mois vs leurs 1-2K).

Enum de plan d’API maintenant : free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack. Nouveau slug WC : astroway-api-vedic-pack.

2026-02-09 — Lal Kitab : forfait complet (+12 points de terminaison)

Douze points de terminaison de l’école védique nord-indienne basée sur les manuscrits Urdu anonymes 1939-1952. L’école entière - JAUNE (intrinsèque - single-school avec des divergences entre les auteurs modernes).

• /vedic/lal-kitab/teva - carte à maisons fixes (maison = signe).
• /vedic/lal-kitab/lal-kundali - disposition de grille 12 maisons.
• /vedic/lal-kitab/kismat + /prosperity - scoring de fortune et de yoga dhana.
• /vedic/lal-kitab/dasha (35 ans) + /varshphal + /life-graph - temporisation.
• /vedic/lal-kitab/debts - détection des 6 Rin (Pitri/Stree/Kanya/Atma/Rishi/Daiva) + remède.
• /vedic/lal-kitab/remedies - upayas par planète (jour / mantra / don).
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}.

Disclaimer affiché dans les réponses. Sources : K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan.

2026-02-06 — Forfait ésotérique ($9 / 200 000 crédits)

Nouveau forfait complémentaire pour les développeurs d’ésotérisme/divination - 180 points de terminaison pour 9 $/mois :

• Forfait esoteric_pack (9 $/mois ou 90 $/an) donne 200 000 crédits et 60 appels/minute.
• Accès limité aux espaces ésotériques/divination (/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa). Tous les autres points de terminaison renvoient 402 PLAN_PACK_MISMATCH.
• Ne se combine pas avec d’autres forfaits sur la même clé - c’est une extension distincte à l’instar du Pack HD.

Enum de plan d’API maintenant : free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack. Nouveaux slugs WC : astroway-api-esoteric-pack (variantes mensuelles + annuelles). Si vous avez créé des clés via /v1/keys sans plan explicite - rien ne change.

2026-02-02 — BaZi + Zi Wei Dou Shu (+17 points de terminaison)

Troisième catégorie chinoise, après le zodiaque chinois + le Feng Shui :

• BaZi (5) - /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}. Piliers d’année et de mois canoniques, piliers de jour et d’heure reportés jusqu’à la vérification croisée avec l’Observatoire de Hong Kong (différentes sources donnent différents ancrages JD).
• Zi Wei Dou Shu MVP (12) - /ziwei/{twelve-palaces, main-stars, full-chart, palace-destiny, palace-siblings, palace-spouse, palace-children, palace-wealth, palace-health, palace-travel, palace-career, palace-property}. MVP - significations de palais + liste des 14 étoiles principales. Carte complète reportée (éphéméride lunaire spécialisée requise).

API expose maintenant 505 points de terminaison - parité avec le concurrent plus large (Astrology-API.io).

2026-01-30 — Bien-être (+9 points de terminaison)

Neuf points de terminaison de bien-être - astrologie médicale + régime + yoga + cristaux, etc. Utilisation éducative uniquement - pas de conseils médicaux, disclaimer dans chaque réponse.

• POST /v1/wellness/medical-astrology - domination corporelle par astrologie traditionnelle Melothesia.
• POST /v1/wellness/diet - nourriture par élément (se concentrer / mettre l’accent / éviter).
• POST /v1/wellness/yoga - focalisation + asanas + pranayama par signe.
• POST /v1/wellness/exercise - intensité + recommandé/éviter par élément.
• POST /v1/wellness/mental-health - profil d’éléments miroir + élément dominant + forces/faiblesses + gestion.
• POST /v1/wellness/sleep-cycles - conseils de sommeil par phases lunaires.
• POST /v1/wellness/herbs - herbes par planète maîtresse du signe (Culpeper 1653).
• POST /v1/wellness/crystals - cristaux par signe + intentions.
• POST /v1/wellness/cycle - repères de bien-être liés à l’âge (retour de Saturne, opposition d’Uranus, …).

Sources : Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible. Niveau - 2 crédits (cycle = 1 crédit).

2026-01-27 — Calendriers mayas (+8 points de terminaison)

Bloc maya : calendrier sacré classique Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night, plus Dreamspell (moderne Argüelles 1990).

• POST /v1/mayan/tzolkin - calendrier sacré 260 jours (numéro 1-13 + nom parmi 20).
• POST /v1/mayan/haab - calendrier civil 365 jours (18 mois × 20 + 5 jours Wayeb).
• POST /v1/mayan/long-count - notation positionnelle 5 places baktun.katun.tun.uinal.kin.
• POST /v1/mayan/calendar-round - calendrier combiné Tzolkin+Haab (cycle 52 ans).
• POST /v1/mayan/lord-of-night - cycle 9 jours (G1-G9).
• POST /v1/mayan/full - tout le classique en un seul appel.
• POST /v1/mayan/compatibility - compatibilité d’une paire par ton/nom/élément/direction.
• POST /v1/mayan/dreamspell - moderne Argüelles (kin 1-260, ton × sceau).

Source : Corrélation Goodman-Martínez-Thompson (Thompson 1935 + Lounsbury 1976). Validation ancre : 2012-12-21 = Long Count 13.0.0.0.0 ✓ (basculement de Bak’tun).

2026-01-23 — Sthira + Shoola Dasha (+10 points de terminaison)

Deux écoles Jaimini rasi-dasha avec cascade complète (maha, antar, pratyantar, sookshma, prana) :

• Sthira - grain = signe de la planète Brahma, MD vers l’avant 12 signes (7 ans mobiles / 8 ans fixes / 9 ans doubles).
• Shoola - grain = stronger_rasi(asc, asc+6), MD vers l’avant 12×9 ans, option antardasaSeedOption ∈ 3.

Ferme le jeu de 10 écoles dasha × 5 niveaux = 50 points de terminaison. Sources : BPHS Adhyayas 49-50 + Jaimini Sutras 2.x.

2026-01-19 — Animal de compagnie + Entreprise + Finances (+36 points de terminaison)

Trois catégories en un seul envoi :

• Animal de compagnie (14) - /pet/{birth-chart, sun-sign-meaning, personality, temperament, training-style, diet-by-sign, grooming-by-element, exercise-needs, communication-style, play-style, health-tips, best-names, lucky-day, owner-pet-compatibility}. Disclaimer : divertissement uniquement - pas de soins vétérinaires.
• Entreprise (12) - /business/{founder-personality, leadership-style, ideal-industry, founding-chart, electional-day, name-suggestions, team-compatibility, customer-archetype, marketing-style, risk-profile, ideal-partner-sign, expansion-timing}. Disclaimer : idéation stratégique, pas de conseil juridique/ fiscal.
• Finances (10) - /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}. ⚠️ PAS DE CONSEIL D’INVESTISSEMENT - disclaimer renforcé dans chaque réponse.

Niveau - 2 crédits (Finances market-timing/wealth-cycle = 3 crédits).

2026-01-16 — Analyse Jaimini (+10 points de terminaison)

Dix points de terminaison d’analyse Jaimini - chara/naisargika karakas, padas (A1..A12 + S1..S12 + M1..M12 + graha arudhas), Upapada, rasi/graha drishti, Karakamsa (AK dans D9), résumé de dasha en cours, yogas Jaimini de base.

Sources : Jaimini Sutras 1-2 + BPHS Adhyayas 26/47.

2026-01-09 — Page de statut + Agents AI + URL de base par défaut

• Page de statut publique : https://api.astroway.info/status - disponibilité, latence p50/p95/p99, mise en cache 60s.
• llms.txt pour les agents AI : https://api.astroway.info/llms.txt - instructions structurées pour les agents Claude / ChatGPT / Perplexity Code.
• URL de base par défaut dans la documentation, serveur MCP, SDK - api.astroway.info/v1 (avec redirection 301 depuis l’ancien api-calc.astroway.info).

2025-12-30 — Tribhagi, Shatabdika, Shodashottari Dashas (+15 points de terminaison)

Trois systèmes nakshatra-dasha avec cascade complète :

• Tribhagi - 1/3-échelle Vimshottari (cycle 40 ans).
• Shatabdika - cycle 100 ans, 7 planètes (sans ombre).
• Shodashottari - cycle 116 ans, 8 planètes (sans Rahu).

Sources : BPHS Adhyaya 46.

2025-12-25 — Compatibilité védique + Muhurat (+18 points de terminaison)

• Compatibilité (6) - appariement Ashta-Koota (Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi) + compatibilité Mangal dosha + résumé Bhrigu.
• Muhurat (12) - électif pour le mariage, les affaires, le voyage, l’éducation, la chirurgie, le fiancé, les types de mahurta.

Sources : BPHS + Muhurta Chintamani.

2025-12-17 — KP (Krishnamurti Paddhati) : forfait complet (+10 points de terminaison)

Dix points de terminaison de l’école KP canonique (K.S. Krishnamurti 1971).

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} - cusps Placidus + chaîne de sous-seigneurs 4 niveaux (signe / étoile / sous / sous-sous).
• /vedic/kp/ruling-planets - Jour/Hora + Asc + chaîne de la Lune, dédoublonnée.
• /vedic/kp/horary - numéro de horaire KP 1..249 → recherche de longitude ASC.
• /vedic/kp/significators - primaire / secondaire / tertiaire par planète.
• /vedic/kp/sub-sub-lord - chaîne à une longitude sidérale arbitraire.
• /vedic/kp/asc-sub - sous-seigneur de l’Ascendant.
• /vedic/kp/fortuna - Part de la Fortune (jour/nuit) + chaîne KP.
• /vedic/kp/transit-kp - positions à l’instant + chaîne KP.

Algorithme : divisions proportionnelles Vimshottari (27 étoiles × 9 sous-seigneurs). Sources : K.S. Krishnamurti Reader I-VI (1971-77).

2025-11-22 — Vimshottari + Yogini + Ashtottari + Kalachakra Dashas (+20 points de terminaison)

Quatre systèmes dasha classiques védiques avec cascade complète (maha, antar, pratyantar, sookshma, prana) :

• Vimshottari - cycle 120 ans, 9 planètes.
• Yogini - cycle 36 ans, 8 yoginis.
• Ashtottari - cycle 108 ans, 8 planètes (sans Ketu), tradition Ardradi.
• Kalachakra - dasha basée sur les signes, paramayu varie par pada (100/85/83/86).

Sources : BPHS Adhyaya 46 + Saravali. Validé contre PyJHora 7.02.

2025-11-08 — Chara Dasha (Jaimini K.N. Rao) (+5 points de terminaison)

École Jaimini rasi-dasha dans la variante K.N. Rao (1995). Direction = avant pour les signes mobiles/doubles de l’ascendant, inverse - pour les signes fixes. Règle de co-seigneur pour le Scorpion (Mars+Ketu) et le Verseau (Saturne+Rahu).

2025-10-25 — Serveur MCP + passerelle AI

• Serveur MCP @astroway/mcp - Protocole de contexte de modèle pour Claude $1, Cursor, Cody. Chaque point de terminaison de l’API est accessible comme outil MCP.
• Passerelle AI - microservice privé distinct ai.astroway.info qui traite les requêtes LLM avec un lien de fournisseur (Gemini Flash → Groq Llama → OpenRouter → Cerebras → SambaNova → Mistral).
• SDK TypeScript attendu dans une version distincte - utilisez pour l’instant la génération de code OpenAPI sur https://api.astroway.info/v1/openapi.json (openapi-typescript / openapi-fetch donnent un client typé avec 612 paires de requête/réponse typées).

2025-10-08 — Yogas védiques + Doshas Parashara (+14 points de terminaison)

• Yogas (7) - Raja, Dhana, Dharma-Karmadhipati, Pancha-Mahapurusha, Gajakesari, Adhi + composite.
• Doshas (7) - Mangal, Kaal Sarp, Pitru, Shrapit, Grahan, Guru-Chandal + composite.

Sources : BPHS Adhyayas 36-39, Phaladeepika.

2025-08-10 — Vargas védiques D1-D60 + Panchang + Shadbala (+31 points de terminaison)

• 16 Vargas D1-D60 (16) - de Rasi (D1) à Shashtiamsa (D60), par BPHS Adhyaya 7.
• Panchang (8) - tithi, vara, nakshatra, yoga, karana + lever/coucher du soleil, abhijit, rahu kaal.
• Shadbala (7) - 6 sources de force par planète + composite (Sthana, Dig, Kala, Cheshta, Naisargika, Drig).

2025-05-18 — Dictionnaires ésotériques + Cristal/Ange/Rêve (+30 points de terminaison)

Extension des dictionnaires de référence : 15 notions ésotériques (chakras, koshas, tattvas, gunas) + 15 tables de recherche de cristaux/anges/rêves. Mises en cache sur le bord (Cloudflare R2).

2025-03-12 — Glossaire de référence + Tarot Lenormand (+24 points de terminaison)

• Référence (14) - dictionnaires de signes, planètes, maisons, aspects, nakshatras, étoiles fixes, symboles sabéens.
• Tarot Lenormand (10) - système 36 cartes : simple, 3 cartes, 9 cartes, Grand Tableau, par question.

2024-11-15 — Tarot Marseille (+20 points de terminaison)

20 points de terminaison du jeu de Marseille : étalages (simple, 3 cartes, Croix, 5 cartes, Croix celtique, année à venir), significations de cartes, mode inversé, par question. Sources : références publiques Camoin / Jodorowsky.

2024-08-25 — Numérologie - forfait complet : Pythagoricien + Chaldéen + Kabbalistique + Védique (+40 points de terminaison)

Quatre systèmes numériques × 10 points de terminaison chacun : chemin de vie, expression, urgence de l’âme, personnalité, anniversaire, maturité, année/personne/mois/jour actuels, compatibilité de nom.

Sources : Pythagoricien (Cheiro 1908), Chaldéen (Cheiro), Kabbalistique hébreu gematria, Védique Chaldéen indien.

2024-05-08 — Tarot Rider-Waite-Smith (+35 points de terminaison)

35 points de terminaison du jeu RWS : tous les étalages canoniques (simple, 3 cartes, Croix celtique, année à venir, relation, 5 cartes fer à cheval, 7 cartes ellipse, décision, situation, mensuel), significations de cartes (droite + inversée), par question, carte quotidienne, mélange de deck.

Sources : Images de Smith PD depuis 2021, Waite “Pictorial Key” 1909 PD.

2024-02-20 — Génération de goroscope AI + interprétations (+12 points de terminaison)

Génération de texte d’interprétation naturel :

• /horoscope/{daily, weekly, monthly} - textes de goroscope pour chaque signe.
• /interpret/{natal, transit, synastry, compatibility} - interprétations détaillées.

Chaîne de fournisseur : GPT-4 → Anthropic Claude → fallback Groq.

2023-11-28 — Matrice de destin (Ladini) (+1 point de terminaison)

/destiny-matrix/ladini - système Natalia Ladini (marché russe/CIS). Méthode à auteur unique avec disclaimer explicite.

2023-09-20 — Chronologie des aspects + harmoniques + indice cyclique (+12 points de terminaison)

Analyse d’aspect étendue :

• /aspect-timeline - moments précis des aspects sur N jours à venir.
• /harmonics/{2..12} - cartes harmoniques.
• /cyclic-index - indice cyclique des tensions sociales d’André Barbo.
• /sabian-symbols - 360 symboles de Marc Edmund Jones.

2023-05-10 — Astrocartographie + Espace local + Géodétique (+18 points de terminaison)

Géo-astrologie :

• /acg + /acg-zones - lignes planétaires d’astrocartographie.
• /local-space - horizon local.
• /parans - parans (Bernadette Brady).
• /relocation - carte de relocalisation.
• /zenith + /horizon + /geodetic - moteurs géo-additionnels.
• /ccg-analysis - analyse CCG/CMG détaillée.

Sources : Jim Lewis Astro*Carto*Graphy, Sepharial Theory of Geodetic Equivalents, Bernadette Brady.

2023-02-15 — Module de conception humaine (+12 points de terminaison)

Moteur de conception humaine complet :

• /human-design - bodygraph (portes, canaux, centres, type, profil, autorité, stratégie, environnement, perspective).
• /hd/incarnation-cross - croix d’incarnation + 4 portes.
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, etc}.

Sources : Ra Uru Hu The Human Design System + Chetan Parkyn + Lynda Bunnell.

2022-08-20 — Synastry serveur + composite

Astrologie relationnelle (synastry, composite, Davison) implémentée sur le serveur. Premiers disponibles via /v1/synastry, /v1/composite, /v1/davison. Marqueur d’extension à l’analyse relationnelle.

Validé contre Solar Fire / Astrodienst - dérive dans les limites de l’erreur de méthode (≤0,5″ sur le calcul moyen).

2022-07-28 — Synastry, composite, Davison + synastry de groupe (+5 points de terminaison)

• /synastry - comparaison de relation avec matrice d’aspects.
• /composite - composite de milieu Robert Hand.
• /davison - composite de temps et de lieu Ronald Davison.
• /group-synastry - matrice de synastry multi-personnes (3+).

Sources : Hand Planets in Composite, Davison Synastry, Lois Sargent.

2022-04-15 — Application Web SPA - produit de consommation en direct

Lancement de app.astroway.info - SPA sur React/TypeScript, qui s’adresse au backend via /v1/*. Comptes d’utilisateurs, cartes enregistrées, sélectionnées. Marqueur de transition d’un site uniquement à un produit complet.

Ce même backend deviendra plus tard la base de l’API publique.

2022-03-18 — Dignités essentielles + réceptions + almuten + parties arabes (+13 points de terminaison)

Astrologie classique :

• /essential-dignities - domicile, exaltation, triplicité, termes, faces.
• /receptions - détection de réception mutuelle.
• /almuten - Almuten Figuris (seigneur de carte).
• /arabic-parts - Lots de Fortune, d’Esprit, d’Éros, de Nécessité et 30+ lots hellénistiques.
• /hyleg - hyleg + alcocoden.
• /algol-minimum + /fixed-stars - étoiles fixes.

Sources : Lilly Christian Astrology + Brennan Hellenistic Astrology.

2021-08-10 — Internal /chart calculation engine

Première implémentation serveur de /chart (privée). Maisons Placidus, offsets sidéraux, calcul des planètes, étoiles fixes. Testé contre Astro.com baseline.

Entièrement Node.js - abandon de la logique PHP-only précédente.

2021-04-05 — Aspects calculation + expansion des systèmes de maisons (+8 points de terminaison)

• /aspects - matrice d’aspects complète avec tables d’orbes (Ptolémée, moderne, astéroïde).
• /coalescent - points coalescents.
• /disposition-chains - chaînes de domination planétaire.
• Expansion des systèmes de maisons : Placidus, Koch, Égal, Tout, Campanus, Regiomontanus, Topocentrique, Porphyry, Alcabitius, Morinus.

2020-07-10 — Aspects matrix + aspects classiques

Stabilisation de l’essence du jeu de calcul. /v1/aspects prêt : prise en charge de la conjonction, de l’opposition, du carré, de la trine, du sextile avec des orbes ptoléméennes. Fondement de toute analyse ultérieure (transits, synastry, retours).

Compilation WASM de Swiss Ephemeris intégrée définitivement - ~5x plus rapide que le modèle analytique précédemment utilisé.

2020-06-15 — Goroscope quotidien/hebdomadaire (+4 points de terminaison)

• /horoscope/daily/{sign} - goroscope quotidien pour chaque signe.
• /horoscope/weekly + /horoscope/monthly - hebdomadaires / mensuels.
• /sun-signs - significations des signes solaires.

Texte généré par l’équipe éditoriale manuelle (textes LLM-augmentés sont arrivés plus tard en 2024).

2020-03-20 — Synastry bêta + éphémérides supplémentaires (+5 points de terminaison)

• /synastry-beta - synastry initiale (lancement complet en 2022).
• /ephemeris/{planets, asteroids, lunar-nodes} - historique 1900-2100.
• /extra - étoiles fixes, Lune noire Lilith, Chiron.

2020-02-20 — API REST squelette + OpenAPI 2.0

Publication de la spécification interne OpenAPI 2.0. Premier espace de noms /v1/*. Authentification via l’en-tête X-Api-Key. Infrastructure de limitation de débit prête.

Jalon interne - l’API publique sera lancée plus tard, mais le contrat est stable à partir de ce moment.

2019-12-15 — Initial release

Premier lancement public de l’API AstroWay Astrology. Fonctionnalité de base :

• /chart - carte natale (planètes, maisons, ascendant, MC).
• /transit - positions de transit actuelles.
• /aspects - aspects de base (conjonctions, oppositions, carrés, trines, sextiles).
• /horoscope - goroscope quotidien (par signe solaire).
• /ephemeris - éphémérides pour n’importe quelle date.
• /health - vérification de santé.

Spécification OpenAPI 2.0, REST/JSON, authentification X-Api-Key. Backend sur Swiss Ephemeris. Forfait gratuit - 1000 appels/mois.

2019-09-01 — Intégration de Swiss Ephemeris - fondation

Bibliothèque Swiss Ephemeris 2.x intégrée dans le backend astroway.info. Précision sub-arcsecond des positions planétaires, des nœuds lunaires, des astéroïdes dans la plage 1900-2100.

Tous les points de terminaison de calcul suivants s’appuient sur cette couche. Même bibliothèque que dans Solar Fire, Kepler, Astro Gold, Astrodienst.