Scor de Compatibilitate¶
Scorul de Compatibilitate analizează 9 numere numerologice principale din două persoane (Calea Vieții, Dorința Inimii, Personalitate etc.) și returnează:
- Profiluri numerologice individuale
- Scoruri de compatibilitate pereche
- Scor general ponderat (0–100)
- Perspectivă asupra relației
Ideal pentru analiza relațiilor, căsătoriei, afacerilor sau prieteniei. Numere Principale: Suport complet (11, 22, 33).
Endpoint¶
| Metodă | Calea |
|---|---|
GET | https://api.numerologyapi.com/api/v1/compatibility-score |
POST | https://api.numerologyapi.com/api/v1/compatibility-score |
Notă
POST uses same path as GET — no /post suffix.
Parametri Necesari¶
X-API-Key: YOUR_API_KEYHost: api.numerologyapi.comContent-Type: application/json(Doar pentru cereri POST)
Creați și gestionați cheile API în dashboard-ul Numerology API.
Parametri¶
Persoana 1¶
| Param | Tip | Necesită | Descriere |
|---|---|---|---|
first_name_1 | string | Da | Numele de familie |
middle_name_1 | string | Nu | Prenume(uri) |
last_name_1 | string | Da | Numele de familie |
dob_1 | string | Da | Data nașterii în formatul YYYY-MM-DD |
num_sys | string | Nu | Sistem numerologic opțional. Valori acceptate: pythagorean, chaldean, vedic. Implicit este pythagorean. |
Persoana 2| Param | Tip | Obligatoriu | Descriere |¶
|---|---|---|---| | first_name_2 | string | Da | Prenume | | middle_name_2 | string | Nu | Nume(le) de mijloc | | last_name_2 | string | Da | Nume de familie | | dob_2 | string | Da | Data nașterii (în YYYY-MM-DD) |
| language | string | Da | Codul limbajului pentru răspuns. Valorile acceptate includ en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh etc. | | lang | string | Da | Alias pentru language. Utilizați fie language, fie lang. |
Adăugați parametrul de interogare opțional
langpentru a localiza răspunsurile. Valorile acceptate:en,fr,es,de,pt,ja,hi,ar,ru,tr,it,pl,nl,id,ko,th,ro,ur,gu,bn,vi,ta,te,mr,pa,zh.
Exemple de Cereri¶
Cerere 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&num_sys=pythagorean" \
--header "X-API-Key: YOUR_API_KEY"
Cerere POST (Corp 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": "",
"num_sys": "pythagorean"
}'
Exemplu de Răspuns
{
"numerology_system": "pythagorean",
"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": "92aa5c5bf8d310f1",
"quota": "unlimited",
"usage_tracking": true
},
"_api_metadata_": {
"api_name": "The Numerology API by Dakidarts®",
"api_version": "1.0.2",
"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-08-18T01:05:42.274217+01:00",
"data_source": "Internal Engine",
"cacheable_status": true,
"report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
"response_language": "en",
"supported_languages": [
"en",
"fr",
"es",
"de",
"pt",
"ja",
"hi",
"ar",
"ru",
"tr",
"it",
"pl",
"nl",
"id",
"ko",
"th",
"ro",
"ur",
"gu",
"bn",
"vi",
"ta",
"te",
"mr",
"pa",
"zh"
],
"notes": ""
}
}
Algoritmul de Evaluare¶
Algoritmul de evaluare a compatibilității utilizează o abordare stratificată, care combină înțelepciunea numerologică cu precizia matematică:
-
Maparea Numărului Principal: Toate numerele (inclusiv numerele principale 11, 22, 33) sunt mapate la vibrațiile lor principale (de exemplu, 11→2, 22→4, 33→6). Calculul utilizează aceste valori principale pentru evaluarea compatibilității.2. Definiții ale perechilor numerologice: Perechile numerologice specifice, cunoscute pentru compatibilitate puternică, sunt atribuite scorurilor de bază predefinite. De exemplu:
(1, 5)and(5, 1): 85 (Adventure-driven combination)(1, 9)and(9, 1): 75 (Leadership meets humanitarianism)(2, 6)and(6, 2): 90 (Nurturing partnership)
-
Calculul de rezervă: Dacă o pereche nu este definită explicit, se utilizează o formulă standard:
base_score = max(25, 100 - root_diff * 10), asigurând un nivel minim de compatibilitate de 25%. -
Bonus pentru rezonanța numărului principal: Perechile care includ Numere Principale primesc puncte suplimentare dacă valorile lor principale sunt identice (+15) sau adiacente (+8), reflectând energia spirituală intensificată.
-
Bonus pentru potrivire exactă: Când ambele numere originale (înainte de reducerea la rădacină) sunt identice, se aplică un bonus suplimentar de +10, recunoscând rezonanța vibrației comune.
-
Calculul final: Scorul total este suma scorului de bază, bonusului pentru numărul principal și bonusului pentru potrivire exactă, limitat la 100%.
Greutăți de punctaj¶
| Factor | Greutate |
|---|---|
| Calea vieții | 1.4 |
| Dorința inimii | 1.35 |
| Numărul destinului | 1.25 |
| Personalitate | 1.15 |
| Pasiune ascunsă | 1.05 |
| Numărul atitudinii | 1.0 |
| Sinele inconștient | 0.85 |
| Numărul echilibrului | 0.8 |
| Gândirea rațională | 0.7 |
| Overall Score = Weighted average of individual scores + Intensity Factor. | |
| Intensity Factor: A small boost (up to +5%) is applied if either person's Life Path or Heart's Desire is a Master Number, reflecting their potential for deeper spiritual connection. |
Overall Insight Levels¶
| Score | Insight |
|---|---|
| ≥ 90 | Exceptional soul-level compatibility |
| ≥ 80 | Very strong & harmonious connection |
| ≥ 70 | Strong & soul-aligned compatibility |
| ≥ 60 | Solid & promising foundation |
| ≥ 50 | Moderate & balanced potential |
| ≥ 40 | Challenging yet teachable dynamic |
| ≥ 25 | Low natural harmony |
| < 25 | Very challenging alignment |
Note
- 9 core numbers compared.
- Hidden Passion: First dominant number used.
- Master Numbers: Fully preserved (11, 22, 33).
- Validation: Missing required fields →
400; Invalid date →400. - Use Case: Dating apps, matchmaking, team building, marriage counseling.
- Caching: Not specified — default behavior.