Ana içeriğe geç

Uyumluluk Skoru

Uyumluluk Skoru, iki kişinin (Yaşam Yolu, Kalbin İsteği, Kişilik vb.) 9 temel numeroloji sayısından analiz yaparak aşağıdaki bilgileri döndürür:

  • Bireysel numeroloji profilleri
  • İki kişi arasındaki uyumluluk puanları
  • Ağırlıklı genel skor (0–100)
  • İlişki analizi

Tanışma, evlilik, iş veya arkadaşlık analizleri için uygundur. Ana Sayılar: Tamamen desteklenir (11, 22, 33).

Endpoint

Yöntem Yol
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.

Gerekli Başlıklar

  • X-API-Key: YOUR_API_KEY
  • Host: api.numerologyapi.com
  • Content-Type: application/json (Sadece POST isteği için)

API anahtarlarını Numerology API panosunda oluşturun ve yönetin.

Parametreler

Kişi 1

Parametre Tür Gerekli Açıklama
first_name_1 string Evet Ad
middle_name_1 string Hayır Orta isim(ler)
last_name_1 string Evet Soyad
dob_1 string Evet Doğum tarihi (YYYY-MM-DD içinde)
num_sys string Hayır İsteğe bağlı numeroloji sistemi. Desteklenen değerler: pythagorean, chaldean, vedic. Varsayılan değer pythagorean'dir.

Kişi 2| Param | Tip | Gerekli | Açıklama |

|---|---|---|---| | first_name_2 | string | Evet | Ad | | middle_name_2 | string | Hayır | Ortadaki isim(ler) | | last_name_2 | string | Evet | Soyadı | | dob_2 | string | Evet | YYYY-MM-DD'de belirtilen doğum tarihi |

| language | string | Evet | Yanıt için dil kodu. Desteklenen değerler şunlardır: en, es, de, fr, pt vb. | | lang | string | Evet | language için kısaltma. Ya language ya da lang'yi kullanın. |

Yanıtları yerelleştirmek için isteğe bağlı lang sorgu parametresini ekleyin. Desteklenen değerler: en, es, de, fr, pt.

Örnek İstekler

GET isteği

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"

POST isteği (JSON gövdesi)

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"
}'

Yanıt örneği

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

Puanlama algoritması

Uyumluluk puanlama algoritması, numerolojik bilgeliği matematiksel kesinlikle birleştirerek çok katmanlı bir yaklaşım kullanır:

  1. Kök sayı eşleme: Tüm sayılar (Master Numbers 11, 22, 33 dahil) kök titreşimlerine eşlenir (örneğin, 11→2, 22→4, 33→6). Hesaplamalar, uyumluluk değerlendirmesi için bu kök değerlerini kullanır.2. Numerolojik Uyum Tanımları: Güçlü uyum için bilinen belirli sayı çiftlerine önceden belirlenmiş temel puanlar atanır. Örneğin:

    • (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. Yedek Hesaplama: Bir çift açıkça tanımlanmadığında, standart bir formül kullanılır: base_score = max(25, 100 - root_diff * 10), minimum %25'lik bir temel uyumun sağlanmasını sağlar.

  3. Ana Sayı Uyum Bonusu: Ana Sayılar içeren çiftlere, kök değerlerinin aynı olması durumunda +15 puan ve birbirine yakın olması durumunda +8 puan verilir, bu da yoğunlaştırılmış ruhsal enerjilerini yansıtır.

  4. Tam Eşleşme Bonusu: Her iki orijinal sayı (kök azaltmadan önce) aynı olduğunda, +10 bonus uygulanır, paylaşılan titreşimlerin uyumunu kabul eder.

  5. Son Hesaplama: Toplam puan, temel puanın, ana sayı bonusunun ve tam eşleşme bonusunun toplamıdır, maksimum %100'e kadar sınırlandırılmıştır.

Puanlama Ağırlıkları

Faktör Ağırlık
Yaşam Yolu 1.4
Kalbin İsteği 1.35
Kader Sayısı 1.25
Kişilik 1.15
Gizli Tutku 1.05
Tavır Sayısı 1.0
Bilinçaltı Ben 0.85
Denge Sayısı 0.8
Mantıklı Düşünce 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

Open Dashboard

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.