호환성 점수¶

호환성 점수는 두 사람(생애 경로, 마음의 욕망, 성격 등)의 9가지 핵심 숫자로부터 분석하여 다음을 반환합니다:

개별 숫자 프로필
쌍대별 호환성 점수
가중치 있는 전체 점수 (0–100)
관계 통찰력

데이트, 결혼, 비즈니스 또는 우정 분석에 적합합니다. 마스터 숫자: 완벽하게 지원 (11, 22, 33).

엔드포인트¶

방법	경로
`GET`	`https://api.numerologyapi.com/api/v1/compatibility-score`
`POST`	`https://api.numerologyapi.com/api/v1/compatibility-score`

참고

POST uses same path as GET — no /post suffix.

필요한 헤더¶

X-API-Key: YOUR_API_KEY
Host: api.numerologyapi.com
Content-Type: application/json (POST 요청만)

Numerology API 대시보드에서 API 키를 생성하고 관리합니다.

매개변수¶

Person 1¶

매개변수	유형	필수	설명
`first_name_1`	문자열	예	이름
`middle_name_1`	문자열	아니오	중간 이름(들)
`last_name_1`	문자열	예	성
`dob_1`	문자열	예	생년월일 (`YYYY-MM-DD` 형식)
`num_sys`	문자열	아니오	선택적인 숫자 시스템. 지원되는 값: `pythagorean`, `chaldean`, `vedic`. 기본값은 `pythagorean`입니다.

Person 2| 파라미터 | 타입 | 필수 | 설명 |¶

|---|---|---|---| | first_name_2 | 문자열 | 예 | 이름 (첫 번째) | | middle_name_2 | 문자열 | 아니오 | 중간 이름(들) | | last_name_2 | 문자열 | 예 | 성 (마지막 이름) | | dob_2 | 문자열 | 예 | YYYY-MM-DD에 있는 생년월일 |

| language | 문자열 | 예 | 응답 언어 코드. 지원되는 값은 en, es, de, fr, pt 등입니다. | | lang | 문자열 | 예 | language의 별칭. language 또는 lang 중 하나를 사용하십시오. |

응답을 로컬화하기 위해 선택 사항인 lang 쿼리 매개변수를 추가합니다. 지원되는 값: en, es, de, fr, pt.

예제 요청¶

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"

POST 요청 (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"
}'

응답 예시¶

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

점수 알고리즘¶

호환성 점수 알고리즘은 수치적 정확성과 함께, 수화학적 지혜를 결합한 다층 접근 방식을 사용합니다:

루트 숫자 매핑: 모든 숫자 (마스터 넘버 11, 22, 33 포함)는 해당 루트 진동으로 매핑됩니다 (예: 11→2, 22→4, 33→6). 계산은 이러한 루트 값을 사용하여 호환성 평가를 수행합니다.2. 숫자 기반 조화 정의: 정수학에서 강한 조화를 나타내는 것으로 알려진 특정 숫자 쌍은 미리 결정된 기본 점수를 할당받습니다. 예를 들어:
- (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)
대체 계산: 해당 쌍이 명시적으로 정의되지 않은 경우, 표준 공식을 사용합니다: base_score = max(25, 100 - root_diff * 10), 최소 25%의 기본 조화를 보장합니다.
마스터 넘버의 조화 보너스: 마스터 넘버를 포함하는 쌍은, 그 근본적인 값이 동일 (+15) 또는 인접 (+8)한 경우 추가 점수를 받습니다. 이는 강화된 영적 에너지를 반영합니다.
정확히 일치하는 보너스: 원래 숫자 (근본 값 감소 전)가 모두 동일한 경우, +10의 추가 보너스가 적용됩니다. 이는 공유된 진동의 조화를 인정합니다.
최종 계산: 총 점수는 기본 점수, 마스터 보너스 및 정확히 일치하는 보너스의 합이며, 100%로 제한됩니다.

점수 가중치¶

요소	가중치
삶의 경로	1.4
마음의 욕망	1.35
운명 숫자	1.25
성격	1.15
숨겨진 열정	1.05
태도 숫자	1.0
무의식적인 자아	0.85
균형 숫자	0.8
이성적 사고	0.7
전체 점수 = 개별 점수의 가중 평균 + 강도 계수.
강도 계수: 개인의 라이프 패스 또는 하트'스 데서가 마스터 넘버인 경우, 심오한 영적 연결 가능성을 반영하여 소폭 보너스가 적용됩니다 (+최대 5%).

전체 통찰 수준¶

점수	통찰
≥ 90	뛰어난 영적인 호환성
≥ 80	매우 강하고 조화로운 연결
≥ 70	강력하고 영적인 일치
≥ 60	견고하고 유망한 기반
≥ 50	적당하고 균형 잡힌 잠재력
≥ 40	도전적이면서도 가르칠 수 있는 역동성
≥ 25	낮은 자연적인 조화
< 25	매우 어려운 정렬

대시보드 보기

참고

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.