The Numerology API 시작하기 – 빠른 시작 튜토리얼¶

The Numerology API에 오신 것을 환영합니다! 이 종합 가이드는 몇 분 만에 첫 번째 수비학 계산을 성공적으로 완료할 수 있도록 도와드립니다. 수비학 앱, 점성술 웹사이트, 일일 별자리 플랫폼 또는 영적 웰빙 도구를 구축하든, 100개 이상의 엔드포인트를 갖춘 당사 API는 전문가 수준의 수비학적 인사이트를 쉽게 추가할 수 있게 해줍니다.

The Numerology API를 선택해야 하는 이유¶

100개 이상의 엔드포인트: Life Path Number, Destiny/Expression Number, Heart's Desire (Soul Urge), Personality Number, Attitude Number, Karmic Debt, Karmic Lessons, Personal Year, Essence Cycles, Minor Expressions, Bridge Numbers 등을 계산할 수 있습니다.
피타고라스 수비학 시스템: 정확하고 시간이 검증된 계산과 상세한 의미, 마스터 넘버 지원(11, 22, 33).
RapidAPI 호스팅: 간단한 구독, 안정적인 가동 시간, 확장 가능한 요금제(무료 티어 이용 가능).
개발자 친화적: GET 및 POST 메서드, JSON 응답, 모든 언어에서 쉬운 통합 지원.

단계별: 가입 및 API 키 받기¶

공식 The Numerology API on RapidAPI 방문
"Subscribe to Test" 클릭 후 요금제 선택:
Basic (Free) – 월 100회 요청 – 테스트에 완벽
Pro – 월 130,000회 요청
Ultra (권장) – 월 550,000회 요청
Mega – 월 2,000,000회 요청
구독 후 "Endpoints" 탭에서 X-RapidAPI-Key를 복사하세요.

첫 번째 요청: Life Path Number 계산¶

Life Path Number는 수비학에서 가장 중요한 숫자 중 하나입니다. GET 엔드포인트를 사용하여 계산하는 방법은 다음과 같습니다.

Python 예제¶

import requests

url = "https://the-numerology-api.p.rapidapi.com/life_path"

# Example: Birth date May 15, 1990
querystring = {
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY_HERE",
    "X-RapidAPI-Host": "the-numerology-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)

if response.status_code == 200:
    data = response.json()
    print(f"Life Path Number: {data['life_path_number']}")
    print(f"Summary: {data['summary']}")
    print(f"Detailed Meaning: {data['detailed_meaning']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

예상 출력 (1997-08-17 기준):

{
  "life_path_number": 11,
  "summary": "The life path number 11 is a master number that represents intuition, spirituality, and enlightenment...",
  "detailed_meaning": "Master Number 11 represents intuition, inspiration, and spiritual insight..."
}

JavaScript (Fetch) 예제¶

const url = "https://the-numerology-api.p.rapidapi.com/life_path";

const options = {
  method: 'GET',
  headers: {
    'X-RapidAPI-Key': 'YOUR_API_KEY_HERE',
    'X-RapidAPI-Host': 'the-numerology-api.p.rapidapi.com'
  },
  // Query parameters
  // Add as URL search params
};

fetch(`${url}?birth_year=1990&birth_month=5&birth_day=15`, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

POST 요청 대안 (JSON 본문)¶

많은 엔드포인트가 GET과 POST를 모두 지원합니다. Life Path의 POST 버전입니다:

payload = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

response = requests.post(url, json=payload, headers=headers)

일반적인 오류 및 문제 해결¶

401 Unauthorized: API 키와 구독 상태를 확인하세요.
400 Bad Request: 필수 매개변수가 올바르게 형식화되어 있는지 확인하세요.
429 Too Many Requests: 요금제 한도를 초과했습니다 – 업그레이드하여 더 많은 요청을 받으세요.

다음 단계¶

이제 첫 번째 호출을 성공적으로 완료했으니, 다음 인기 엔드포인트를 탐색해보세요:

/destiny_number – 이름 기반 Expression Number
/heart_desire – 모음에서 추출한 Soul Urge
/karmic_debt – 13, 14, 16, 19 감지
/personal_year – 현재 연도 예측

전체 API Reference를 탐색하여 100개 이상의 엔드포인트를 확인하세요.

멋진 것을 구축할 준비가 되셨나요? 지금 바로 수비학 계산, 점성술 기능, 개인 맞춤형 별자리를 통합해보세요!

Tags: #numerologyapi #lifepathnumber #destinynumber #numerologytutorial #pythonapi #rapidapi #spiritualapp #astrologyapi #horoscopeapi #gettingstarted #pythagoreannumerology #masternumbers