API v1 · développeurs et assistants · compatibilite

La compatibilité de deux thèmes

La 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.

Ce qu’il reçoit

Deux naissances : date1, heure1, ville1… et date2, heure2, ville2… en GET ; personne1 et personne2 en JSON.

Les options

Option	Valeurs	Défaut	Ce qu’elle fait
`zodiaque`	`tropical`, `vedique`, `les_deux`	`tropical`	« tropical » (la synastrie occidentale, le défaut), « vedique » (les cartes védiques des deux personnes, côte à côte) ou « les_deux ».
`cartes`	une liste parmi `D1`, `D2`, `D3`, `D4`, `D5`, `D6`, `D7`, `D8`, `D9`, `D10`, `D11`, `D12`, `D16`, `D20`, `D24`, `D27`, `D30`, `D40`, `D45`, `D60`, `toutes`	vide	En védique : les cartes de chaque personne (« D9 » pour le lien, « D7 » pour les enfants…, « toutes ») ; le D1 toujours ; [] : le D1 et le D9.

L’appeler

En GET

https://montheme.fr/api/v1/compatibilite?date1=1990-05-12&heure1=14:30&ville1=Lyon&pays1=FR&prenom1=Camille&date2=1992-11-03&heure2=08:15&ville2=Bordeaux&pays2=FR&prenom2=Hugo&zodiaque=les_deux&cartes=D9

En POST, avec un corps JSON

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

{
  "personne1": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "personne2": {
    "date": "1992-11-03",
    "heure": "08:15",
    "ville": "Bordeaux",
    "pays": "FR",
    "prenom": "Hugo"
  },
  "zodiaque": "les_deux",
  "cartes": [
    "D9"
  ]
}

Avec le serveur MCP (outil `compatibilite`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compatibilite",
    "arguments": {
      "person1": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "person2": {
        "date": "1992-11-03",
        "time": "08:15",
        "city": "Bordeaux",
        "country": "FR",
        "name": "Hugo"
      },
      "zodiaque": "les_deux",
      "cartes": [
        "D9"
      ],
      "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
`personnes`	array
`tropical`	object
`vedique`	object

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

{
  "outil": "compatibilite",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/synastrie/calcul?date1=1990-05-12&heure1=14%3A30&ville1=Lyon&pays1=FR&prenom1=Camille&date2=1992-11-03&heure2=08%3A15&ville2=Bordeaux&pays2=FR&prenom2=Hugo"
  },
  "resultat": {
    "zodiaque": "les_deux",
    "personnes": [
      {
        "nom": "Camille",
        "bigThree": {
          "soleil": "Taureau",
          "lune": "Sagittaire",
          "ascendant": "Vierge"
        },
        "venus": "Bélier",
        "mars": "Poissons",
        "heureInconnue": false
      },
      {
        "nom": "Hugo",
        "bigThree": {
          "soleil": "Scorpion",
          "lune": "Verseau",
          "ascendant": "Scorpion"
        },
        "venus": "Sagittaire",
        "mars": "Cancer",
        "heureInconnue": false
      }
    ],
    "tropical": {
      "notes": {
        "amour": 5,
        "communication": 3,
…

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 calcul de compatibilité (synastrie).

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