API v1 · développeurs et assistants · horoscope

L’horoscope d’un signe

L’horoscope d’un signe solaire, celui des pages du site, composé par règles depuis les vrais transits : un jour, une semaine, un mois ou une année ; les notes (amour, travail, énergie), le climat, l’amour, le travail, l’énergie, le conseil, les dates clés.

Ce qu’il reçoit

Aucune naissance : seulement les options ci-dessous.

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`signe`	`belier`, `taureau`, `gemeaux`, `cancer`, `lion`, `vierge`, `balance`, `scorpion`, `sagittaire`, `capricorne`, `verseau`, `poissons`	exigée	Le signe : belier, taureau, gemeaux, cancer, lion, vierge, balance, scorpion, sagittaire, capricorne, verseau, poissons.
`periode`	`jour`, `semaine`, `mois`, `annee`	`jour`	« jour » (le défaut), « semaine » (du lundi au dimanche), « mois » (civil) ou « annee » (civile).
`date`	une date AAAA-MM-JJ, ou vide	vide	Un jour de la période voulue, AAAA-MM-JJ ; « » : aujourd’hui.

L’appeler

En GET

https://montheme.fr/api/v1/horoscope?signe=scorpion&periode=semaine&date=2026-11-02

En POST, avec un corps JSON

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

{
  "signe": "scorpion",
  "periode": "semaine",
  "date": "2026-11-02"
}

Avec le serveur MCP (outil `horoscope`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "horoscope",
    "arguments": {
      "signe": "scorpion",
      "periode": "semaine",
      "date": "2026-11-02",
      "language": "fr"
    }
  }
}

Ce qu’il rend

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

Clé	Type
`signe`	string
`periode`	string
`debut`	string
`fin`	string
`notes`	object
`climat`	string
`amour`	string
`travail`	string
`energie`	string
`conseil`	string

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

{
  "outil": "horoscope",
  "version": "1",
  "resultat": {
    "signe": "Scorpion",
    "signeId": "scorpion",
    "periode": "semaine",
    "debut": "2026-11-02",
    "fin": "2026-11-08",
    "notes": {
      "amour": 3,
      "travail": 3,
      "energie": 3,
      "global": 3
    },
    "motCle": "Magnétisme",
    "climat": "Le Soleil est dans votre signe : c’est votre saison, celle où l’on vous voit et où vos projets prennent de l’élan. La Lune traverse Lion, Vierge, Balance, Scorpion : les jours où elle est dans votre signe ou en trigone sont vos meilleurs moments de la semaine.",
    "amour": "Climat affectif calme : parfait pour un moment à deux sans enjeu, ou pour prendre soin de vous. Vénus est rétrograde : les histoires du passé refont surface, et c’est le moment de revoir ce que vous attendez vraiment de l’amour, pas de vous engager à la hâte.",
    "travail": "Mercure dans votre signe : votre esprit est vif, vos mots portent. Écrivez, négociez, exprimez-vous. Tension d’énergie : Mars vous pousse à forcer. Dépensez-vous physiquement plutôt que de vous disputer. Jupiter en carré : attention à l’excès de confiance ou aux promesses trop grandes. Vérifiez les chiffres. Mercure rétrograde : relisez contrats et messages, sauvegardez vos fichiers, et préférez reprendre un dossier ancien plutôt qu’en lancer un nouveau.",
    "energie": "Énergie moyenne et stable : alternez effort et récupération, ne forcez pas en fin de journée.",
    "conseil": "Faites simple : une chose bien faite vaut mieux que trois à moitié.",
    "datesCles": []
  }
}

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 : l’horoscope des douze signes.

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