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_KEYHost: api.numerologyapi.comContent-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ı
langsorgu 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:
-
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)
-
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. -
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.
-
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.
-
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 |
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.