API v1 · développeurs et assistants
Les outils de l’API v1 : le calcul de Véga, en JSON
Les mêmes outils que Véga, le chat du site : chacun calcule une chose, au lieu et à la minute près, et la rend en JSON. Sans compte, sans clé, en lecture seule ; une page par outil dit ce qu’il reçoit, ses options et ce qu’il rend.
Comment ça marche
- Une adresse par outil :
https://montheme.fr/api/v1/<outil>, en GET (les paramètres dans l’adresse) ou en POST (un corps JSON).GET https://montheme.fr/api/v1rend le catalogue. - Une naissance se donne comme sur les pages du site :
date,heure,ville(oulat,lon,tz),pays,prenom; deux personnes :date1,date2… en GET,personne1etpersonne2en JSON. - La réponse :
{ outil, version, partage, resultat }.resultatne contient jamais la naissance ;partage.lienest la page du thème sur le site, à donner à la personne. - CORS ouvert, aucune authentification ; 60 appels par minute et 2 000 par jour par adresse IP.
lang=enpour l’anglais (les clés restent en français). - Le même calcul que le site : les positions, les dates et les périodes viennent du calcul, jamais d’une estimation. Merci de citer la source.
Les outils
Chaque outil a sa page : ce qu’il reçoit, ses options, un appel en GET, en POST et par le serveur MCP, et la réponse réelle de cet exemple.
- Calculer un thème
calculer_themeCalcule un thème avec le site, à la minute : en occidental (le défaut), en védique, ou les deux dans le même appel pour les croiser. - Les dashas de Vimshottari
dashasLes périodes de Vimshottari (astrologie védique) d’un thème, calculées par le site depuis la nakshatra de la Lune : la grande période et la sous-période en cours, la suivante, puis les grandes périodes et leurs sous-périodes datées sur une plage. - Les transits d’un thème
transitsLes 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. - La révolution solaire
revolution_solaireLa révolution solaire d’un thème pour une année, calculée par le site : l’instant où le Soleil revient à son degré de naissance, l’Ascendant de l’année, le Soleil et la Lune en maisons, les positions, les aspects et la lecture de l’année par règles. - La compatibilité de deux thèmes
compatibiliteLa compatibilité de deux thèmes, calculée par le site : les aspects croisés avec leurs orbes, les notes en étoiles de 1 à 5 (amour, communication, durée, passion, global), les appuis, les leviers et la lecture du lien ; en védique, les cartes des deux personnes côte à côte (le D1 et le D9 par défaut, ou celles demandées) et la nakshatra de chaque Lune, à croiser. - Le ciel d’une date
cielLe 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. - Le calendrier du ciel
calendrierLe 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. - L’horoscope d’un signe
horoscopeL’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. - Les textes du site
textes_du_siteCe que les textes rédigés de montheme.fr disent d’un sujet d’astrologie : le titre, l’accroche, les paragraphes, les forces, les défis et le conseil des pages qui le traitent (deux au plus). - Chercher sur le site
chercher_sur_le_siteLa recherche de montheme.fr (la même que sa loupe) : les pages qui correspondent (cinq au plus), avec leur titre, leur adresse et un extrait.
Avec le serveur MCP
Les mêmes outils, sous les mêmes noms, sont dans le serveur MCP du site (https://montheme.fr/api/mcp) : la naissance s’y donne en birth (ou person1 et person2), et la réponse arrive en JSON structuré.
La spécification
L’OpenAPI 3.1, générée depuis la même liste d’outils : https://montheme.fr/api/openapi.json
Toute la documentation pour les assistants et les développeurs