API v1 · développeurs et assistants · transits

Les transits d’un thème

Les transits sur un thème, le même calcul que la page « Mes transits » : un jour, une semaine, un mois ou une plage de dates ; les planètes lentes ou toutes. Chaque passage avec sa forme (« Saturne carré Soleil »), son orbe, s’il se resserre, sa fenêtre et son passage exact ; les maisons natales traversées (heure connue).

Ce qu’il reçoit

Une naissance : date (exigée), heure, ville ou lat et lon, pays, tz, prenom.

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`periode`	`jour`, `semaine`, `mois`, `plage`	`semaine`	« jour » (la Lune du jour et les rapides exactes ce jour-là, sur les lentes en cours), « semaine » (le défaut : les grands transits en cours, ceux qui se forment, les rapides de la semaine, les maisons traversées, les Nœuds), « mois » (les fenêtres des lentes sur le mois qui suit le début, leurs passages exacts, les entrées en maisons), « plage » (la même chose du début à la fin).
`debut`	une date AAAA-MM-JJ, ou vide	vide	Le jour, la semaine ou le début de la période, AAAA-MM-JJ ; « » : aujourd’hui.
`fin`	une date AAAA-MM-JJ, ou vide	vide	Avec « plage » : la fin, AAAA-MM-JJ, deux ans au plus après le début ; « » : trois mois après.
`planetes`	`toutes`, `lentes`	`toutes`	« toutes » (le défaut : les lentes et les rapides, la Lune comprise pour un jour) ou « lentes » (Jupiter à Pluton seulement).

L’appeler

En GET

https://montheme.fr/api/v1/transits?date=1990-05-12&heure=14:30&ville=Lyon&pays=FR&prenom=Camille&periode=mois&debut=2027-01-01&planetes=lentes

En POST, avec un corps JSON

POST https://montheme.fr/api/v1/transits
Content-Type: application/json

{
  "naissance": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "periode": "mois",
  "debut": "2027-01-01",
  "planetes": "lentes"
}

Avec le serveur MCP (outil `transits`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "transits",
    "arguments": {
      "birth": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "periode": "mois",
      "debut": "2027-01-01",
      "planetes": "lentes",
      "language": "fr"
    }
  }
}

Ce qu’il rend

La réponse contient outil, version, partage.lien (la page du thème sur le site, à donner à la personne), et resultat, dont voici les clés :

Clé	Type
`periode`	string
`debut`	string
`fin`	string
`heureConnue`	boolean

Ce que rend cet exemple (le début), calculé par le site au moment de la page :

{
  "outil": "transits",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/theme-astral/resultat?date=1990-05-12&heure=14%3A30&ville=Lyon&pays=FR&prenom=Camille"
  },
  "resultat": {
    "periode": "mois",
    "debut": "2027-01-01",
    "fin": "2027-02-01",
    "heureConnue": true,
    "fenetres": [
      {
        "forme": "Saturne carré Jupiter",
        "transitId": "saturne",
        "aspect": "carre",
        "natal": "jupiter",
        "debut": "2027-01-01",
        "fin": "2027-01-29",
        "exacts": [
          "2027-01-14"
        ],
        "dejaEnCours": true
      },
      {
        "forme": "Pluton trigone Milieu du Ciel",
        "transitId": "pluton",
        "aspect": "trigone",
        "natal": "mc",
        "debut": "2027-01-01",
        "fin": "2027-02-01",
        "exacts": [],
        "dejaEnCours": true
      },
      {
        "forme": "Saturne conjonction Vénus",
…

CORS ouvert, aucune authentification ; 60 appels par minute et 2 000 par jour par adresse IP. lang=en pour l’anglais (les clés restent en français).

Le même calcul sur le site

Ce que cet outil calcule, le site le montre aussi à la personne : les transits du moment.

Les autres outils

← Les outils de l’API v1 : le calcul de Véga, en JSON Toute la documentation pour les assistants et les développeurs OpenAPI