Score de compatibilité¶
Le Score de compatibilité analyse 9 chiffres fondamentaux de la numérologie provenant de deux individus (Chemin de vie, Désir du cœur, Personnalité, etc.) et renvoie :
- Profils de numérologie individuels
- Scores de compatibilité par paires
- Score global pondéré (0–100)
- Perspective sur la relation
Parfait pour l'analyse des rencontres, du mariage, des affaires ou de l'amitié. Nombres maîtres : Pris en charge entièrement (11, 22, 33).
Point de terminaison¶
| Méthode | Chemin |
|---|---|
GET | https://api.numerologyapi.com/api/v1/compatibility-score |
POST | https://api.numerologyapi.com/api/v1/compatibility-score |
Note
GET utilise le même chemin que POST — pas de suffixe /post.
En-têtes requis¶
X-API-Key: YOUR_API_KEYHost: api.numerologyapi.comContent-Type: application/json(Uniquement pour POST)
Créez et gérez les clés API dans le tableau de bord Numerology API.
Paramètres¶
Personne 1¶
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
first_name_1 | chaîne | Oui | Prénom |
middle_name_1 | chaîne | Non | Nom du milieu |
last_name_1 | chaîne | Oui | Nom de famille |
dob_1 | chaîne | Oui | Date de naissance au format YYYY-MM-DD |
Personne 2¶
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
first_name_2 | chaîne | Oui | Prénom |
middle_name_2 | chaîne | Non | Nom du milieu |
last_name_2 | chaîne | Oui | Nom de famille |
dob_2 | chaîne | Oui | Date de naissance au format YYYY-MM-DD |
Ajoutez le paramètre de requête optionnel
langpour localiser les réponses. Valeurs prises en charge :en,es,de,fr,pt.
Exemples de requêtes¶
Requête GET¶
curl --request GET \
--url "https://api.numerologyapi.com/api/v1/compatibility-score?first_name_1=John&last_name_1=Doe&first_name_2=John&last_name_2=Doe&dob_1=1992-07-16&dob_2=1992-07-16&middle_name_1=&middle_name_2=&lang=en" \
--header "X-API-Key: YOUR_API_KEY"
Requête POST (Corps JSON)¶
curl --request POST \
--url "https://api.numerologyapi.com/api/v1/compatibility-score?lang=en" \
--header "X-API-Key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"first_name_1": "John",
"last_name_1": "Doe",
"first_name_2": "John",
"last_name_2": "Doe",
"dob_1": "1992-07-16",
"dob_2": "1992-07-16",
"middle_name_1": "",
"middle_name_2": ""
}'
Exemple de réponse¶
{
"person_1": {
"full_name": "John Doe",
"initials": "JD",
"dob": "1992-07-16",
"life_path": 8,
"heart_desire": 8,
"personality": 9,
"hidden_passion": [
5,
6
],
"destiny_number": 8,
"attitude_number": 5,
"subconscious_self_number": 5,
"balance_number": 5,
"rational_thought_number": 9
},
"person_2": {
"full_name": "John Doe",
"initials": "JD",
"dob": "1992-07-16",
"life_path": 8,
"heart_desire": 8,
"personality": 9,
"hidden_passion": [
5,
6
],
"destiny_number": 8,
"attitude_number": 5,
"subconscious_self_number": 5,
"balance_number": 5,
"rational_thought_number": 9
},
"compatibility_scores": {
"life_path_score": 80,
"heart_desire_score": 80,
"personality_score": 85,
"hidden_passion_score": 95,
"destiny_number_score": 80,
"attitude_number_score": 95,
"subconscious_self_score": 95,
"balance_number_score": 95,
"rational_thought_score": 85,
"overall_score": 86.8,
"overall_insight": "Very strong & harmonious connection. Your energies flow together with grace and mutual support. This is a relationship that feels like 'coming home' — powerful synergy with only gentle adjustments needed."
},
"_enterprise": {
"client": "The Numerology API",
"plan": "Enterprise",
"request_id": "ced3a432226491dc",
"quota": "unlimited",
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "0.1.1",
"endpoint_name": "compatibility_score",
"endpoint_description": "Computes numerology compatibility score between two individuals.",
"developer": "Dakidarts®",
"copyright": "© 2026 Dakidarts®. All rights reserved.",
"documentation_url": "https://docs.numerologyapi.com/",
"response_timestamp": "2026-02-28T07:36:26.749083+01:00",
"data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"es",
"de",
"fr",
"pt"
],
"notes": ""
}
}
Algorithme de notation¶
L'algorithme de notation de la compatibilité utilise une approche multicouche qui combine la sagesse numérologique avec la précision mathématique :
-
Mappage du nombre de base : Tous les nombres (y compris les nombres maîtres 11, 22, 33) sont mappés à leurs vibrations de base (par exemple, 11→2, 22→4, 33→6). Les calculs utilisent ces valeurs de base pour l'évaluation de la compatibilité.
-
Définitions de paires numérologiques : Des paires de nombres spécifiques connues pour une forte compatibilité en numérologie sont attribuées à des scores de base prédéfinis. Par exemple :
(1, 5)et(5, 1): 85 (Combinaison axée sur l'aventure)(1, 9)et(9, 1): 75 (Leadership et humanitarisme)(2, 6)et(6, 2): 90 (Partenariat nourrissant)
-
Calcul de secours : Si une paire n'est pas explicitement définie, une formule standard est utilisée :
base_score = max(25, 100 - root_diff * 10), garantissant une compatibilité de base minimale de 25 %. -
Bonus de résonance des nombres maîtres : Les paires impliquant des nombres maîtres reçoivent des points supplémentaires si leurs valeurs de base sont identiques (+15) ou adjacentes (+8), reflétant leur énergie spirituelle accrue.
-
Bonus de correspondance exacte : Lorsqu'à la fois les nombres d'origine (avant réduction) sont identiques, un bonus supplémentaire de +10 est appliqué, reconnaissant la résonance de la vibration partagée.
-
Calcul final : Le score total est la somme du score de base, du bonus maître et du bonus de correspondance exacte, limité à 100 %.
Poids de notation¶
| Facteur | Poids |
|---|---|
| Chemin de vie | 1,4 |
| Désir du cœur | 1,35 |
| Nombre de destin | 1,25 |
| Personnalité | 1,15 |
| Passion secrète | 1,05 |
| Nombre de l'attitude | 1,0 |
| Soi subconscient | 0,85 |
| Nombre d'équilibre | 0,8 |
| Pensée rationnelle | 0,7 |
Score global = moyenne pondérée des scores individuels + Facteur d'intensité. Facteur d'intensité : Un léger boost (jusqu'à +5 %) est appliqué si l'un des chemins de vie ou des désirs du cœur d'une personne est un nombre maître, reflétant leur potentiel de connexion spirituelle plus profonde.
Niveaux d'insight globaux¶
| Score | Insight |
|---|---|
| ≥ 90 | Compatibilité de niveau âme exceptionnelle |
| ≥ 80 | Connexion très forte et harmonieuse |
| ≥ 70 | Compatibilité de niveau âme et alignée |
| ≥ 60 | Fondement solide et prometteur |
| ≥ 50 | Potentiel modéré et équilibré |
| ≥ 40 | Dynamique stimulante mais enseignable |
| ≥ 25 | Harmonie naturelle faible |
| < 25 | Alignement très faible |
Note
- 9 chiffres fondamentaux comparés.
- Passion secrète : premier nombre dominant utilisé.
- Nombres maîtres : entièrement conservés (11, 22, 33).
- Validation : Champs requis manquants →
400; Date invalide →400. - Cas d'utilisation : applications de rencontres, mise en correspondance, développement d'équipe, conseil conjugal.
- Mise en cache : non spécifiée — comportement par défaut.