API v1 · développeurs et assistants · ciel

Le ciel d’une date

Le ciel d’un jour, le même pour tout le monde, calculé par le site (Paris, à midi ; « » : maintenant) : les planètes en signes, leurs degrés et leurs rétrogradations, les aspects du ciel, la phase de la Lune.

Ce qu’il reçoit

Aucune naissance : seulement les options ci-dessous.

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`date`	une date AAAA-MM-JJ, ou vide	vide	Le jour, AAAA-MM-JJ (calculé à midi, heure de Paris) ; « » : maintenant.

L’appeler

En GET

https://montheme.fr/api/v1/ciel?date=2026-12-21

En POST, avec un corps JSON

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

{
  "date": "2026-12-21"
}

Avec le serveur MCP (outil `ciel`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ciel",
    "arguments": {
      "date": "2026-12-21",
      "language": "fr"
    }
  }
}

Ce qu’il rend

La réponse contient outil, version, et resultat, dont voici les clés :

Clé	Type
`date`	string
`heure`	string
`lieu`	string
`planetes`	array
`aspects`	array
`lune`	object

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

{
  "outil": "ciel",
  "version": "1",
  "resultat": {
    "date": "2026-12-21",
    "heure": "12:00",
    "lieu": "Paris",
    "planetes": [
      {
        "id": "soleil",
        "nom": "Soleil",
        "signe": "Sagittaire",
        "signeId": "sagittaire",
        "position": "29°34' Sagittaire",
        "degreDansSigne": 29.58,
        "retrograde": false
      },
      {
        "id": "lune",
        "nom": "Lune",
        "signe": "Taureau",
        "signeId": "taureau",
        "position": "22°56' Taureau",
        "degreDansSigne": 22.95,
        "retrograde": false
      },
      {
        "id": "mercure",
        "nom": "Mercure",
        "signe": "Sagittaire",
        "signeId": "sagittaire",
        "position": "23°14' Sagittaire",
        "degreDansSigne": 23.25,
        "retrograde": false
      },
      {
…

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 ciel du jour.

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