API v1 · développeurs et assistants · calendrier

Le calendrier du ciel

Le calendrier du ciel sur une période, calculé par le site : les nouvelles et pleines lunes (date, heure de Paris, signe, degré, éclipse), les éclipses, les rétrogrades (station rétrograde, station directe, zone d’ombre), les entrées des planètes dans les signes. Avec un thème, la maison natale où tombe chaque lunaison et ses aspects à trois degrés au plus.

Ce qu’il reçoit

Une naissance, facultative : avec elle, le résultat se rapporte à ce thème (sa maison natale, ses aspects).

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`debut`	une date AAAA-MM-JJ, ou vide	vide	Le premier jour, AAAA-MM-JJ ; « » : aujourd’hui.
`fin`	une date AAAA-MM-JJ, ou vide	vide	Le dernier jour, AAAA-MM-JJ, deux ans au plus après le début ; « » : trois mois après.
`evenements`	une liste parmi `lunaisons`, `eclipses`, `retrogrades`, `ingres`	vide	Ce qu’il faut : « lunaisons » (nouvelles et pleines lunes), « eclipses », « retrogrades » (stations et zones d’ombre), « ingres » (entrées en signe) ; [] : tout.
`planetes`	une liste parmi `soleil`, `mercure`, `venus`, `mars`, `jupiter`, `saturne`, `uranus`, `neptune`, `pluton`	vide	Pour les rétrogrades et les entrées en signe : les planètes voulues ; [] : toutes (le Soleil n’a pas de rétrogradation).

L’appeler

En GET

https://montheme.fr/api/v1/calendrier?debut=2027-01-01&fin=2027-03-31&evenements=lunaisons,retrogrades

En POST, avec un corps JSON

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

{
  "debut": "2027-01-01",
  "fin": "2027-03-31",
  "evenements": [
    "lunaisons",
    "retrogrades"
  ]
}

Avec le serveur MCP (outil `calendrier`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calendrier",
    "arguments": {
      "debut": "2027-01-01",
      "fin": "2027-03-31",
      "evenements": [
        "lunaisons",
        "retrogrades"
      ],
      "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
`debut`	string
`fin`	string
`lunaisons`	array
`eclipses`	array
`retrogrades`	array
`ingres`	array

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

{
  "outil": "calendrier",
  "version": "1",
  "resultat": {
    "debut": "2027-01-01",
    "fin": "2027-03-31",
    "lunaisons": [
      {
        "type": "nouvelle",
        "date": "2027-01-07",
        "heureParis": "21:25",
        "signe": "Capricorne",
        "signeId": "capricorne",
        "degre": 17.31
      },
      {
        "type": "pleine",
        "date": "2027-01-22",
        "heureParis": "13:17",
        "signe": "Lion",
        "signeId": "lion",
        "degre": 2.24
      },
      {
        "type": "nouvelle",
        "date": "2027-02-06",
        "heureParis": "16:56",
        "signe": "Verseau",
        "signeId": "verseau",
        "degre": 17.63,
        "eclipse": "annular"
      },
      {
        "type": "pleine",
        "date": "2027-02-21",
        "heureParis": "00:24",
…

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 : le calendrier lunaire.

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