Punteggio di Compatibilità¶

Il Punteggio di Compatibilità analizza 9 numeri numerologici fondamentali provenienti da due individui (Via della Vita, Desiderio del Cuore, Personalità, ecc.) e restituisce:

• Profili numerologici individuali
• Punteggi di compatibilità tra coppie
• Punteggio complessivo ponderato (0–100)
• Insight sulla relazione

Ideale per l'analisi delle relazioni sentimentali, del matrimonio, degli affari o dell'amicizia. Numeri Maestri: Completamente supportati (11, 22, 33).

Endpoint¶

Intestazioni Richieste¶

• X-API-Key: YOUR_API_KEY
• Host: api.numerologyapi.com
• Content-Type: application/json (solo per richieste POST)

Crea e gestisci le chiavi API nel pannello di controllo Numerology API.

Parametri¶

Persona 1¶

Persona 2| Parametro | Tipo | Obbligatorio | Descrizione |¶

|---|---|---|---| | first_name_2 | stringa | Sì | Nome | | middle_name_2 | stringa | No | Cognome(i) | | last_name_2 | stringa | Sì | Cognome | | dob_2 | stringa | Sì | Data di nascita in YYYY-MM-DD |

| language | stringa | Sì | Codice lingua per la risposta. I valori supportati includono en, es, de, fr, pt, ecc. | | lang | stringa | Sì | Alias per language. Utilizzare o language o lang. |

Aggiungere il parametro di query opzionale lang per localizzare le risposte. Valori supportati: en, es, de, fr, pt.

Esempi di Richieste¶

Richiesta 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"

Richiesta POST (Corpo 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"
}'

Esempio di Risposta¶

{
  "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": "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": ""
  }
}

Algoritmo di Punteggio¶

L'algoritmo di punteggio di compatibilità utilizza un approccio a più livelli che combina la saggezza numerologica con la precisione matematica:

1. Mappatura del Numero Radice: Tutti i numeri (inclusi i numeri Master 11, 22, 33) vengono mappati alle loro vibrazioni radici (ad esempio, 11→2, 22→4, 33→6). I calcoli utilizzano questi valori di base per la valutazione della compatibilità.2. Definizioni di Coppie Numerologiche: Le specifiche coppie numeriche note per una forte compatibilità in numerologia vengono assegnate a punteggi base predefiniti. Ad esempio:

   • (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)

2. Calcolo di Riserva: Se una coppia non è esplicitamente definita, viene utilizzata una formula standard: base_score = max(25, 100 - root_diff * 10), garantendo un livello minimo di compatibilità del 25%.

3. Bonus per la Risonanza dei Numeri Maestri: Le coppie che coinvolgono Numeri Maestri ricevono punti aggiuntivi se i loro valori radicali sono identici (+15) o adiacenti (+8), riflettendo la loro intensificata energia spirituale.

4. Bonus per Corrispondenza Esatta: Quando entrambi i numeri originali (prima della riduzione al valore radicale) sono identici, viene applicato un bonus extra di +10, riconoscendo la risonanza delle vibrazioni condivise.

5. Calcolo Finale: Il punteggio totale è la somma del punteggio base, del bonus per il numero maestro e del bonus per la corrispondenza esatta, limitato al 100%.

Pesi di Valutazione¶

Overall Insight Levels¶

Open Dashboard