수비학은 보통 API가 완전히 건너뛰거나 하나의 피타고라스식 “life path number”로 축소하는 에소테릭 스택의 일부야. 우리는 다른 길을 택했어: 5개의 완전한 시스템, 각각 10개의 정규 계산을 하나의 파라미터화된 경로로 제공해.
함께라면 /numerology/{system}/{calc} 아래에 50개의 엔드포인트와 별도의 운명 매트릭스가 있어. 아래에서 어떻게 구성됐는지와 왜 하나의 경로만으로 충분한지 설명할게.
하나의 경로, 다섯 시스템
섹션 제목: “하나의 경로, 다섯 시스템”모든 계산은 템플릿 아래에 살아:
POST /v1/numerology/{system}/{calc}{system} - 다섯 값 중 하나야. 각 시스템은 자체 문자 → 숫자 매핑 테이블과 고유한 축소 규칙을 가지고 있어서 같은 이름이라도 학교에 따라 결과가 달라.
system | 학교 | 핵심 차이점 |
|---|---|---|
pythagorean | 피타고라스식 | 라틴 알파벳 1-9를 알파벳 순서대로 매핑하고, 1-9로 축소하며 마스터 넘버 11/22/33 포함 |
chaldean | 칼데아식 | 1-8 표(9 제외), 소리 진동에 따라 숫자를 매핑, 위치가 아니라 |
kabbalistic | 카발라식 (음성) | 이름의 음성 발음에 따라 값 매핑 |
kabbalistic-strict | 카발라식 (Mathers strict) | Mathers 기준의 엄격한 히브리어 중심 표, 음성 근사 없이 |
vedic | 베다식 | 산스크리트 대응표 기반, 출생 숫자에 초점 |
알 수 없는 시스템은 허용 가능한 값 목록과 함께 400 INVALID_SYSTEM을 반환해 - 피타고라스식으로 조용히 폴백하지 않아.
시스템당 열 개의 계산
섹션 제목: “시스템당 열 개의 계산”같은 10개의 계산 세트가 다섯 시스템 모두에 제공돼:
life-path- 출생일 기반 삶의 경로 번호expression- 전체 이름에서 도출된 표현/운명 번호soul-urge- 모음만으로 계산한 영혼 번호personality- 자음만으로 계산한 성격 번호birthday- 생일 번호maturity- 성숙도 번호 (life-path + expression)balance- 균형 번호 (이니셜)challenge- 도전 번호들pinnacles- 정점 번호들 (인생 단계)personal-year- 개인 연도 번호
대부분 호출의 요청 본문은 이름과 날짜만 포함해:
{ "name": "Ada Lovelace", "date": "1815-12-10" }personal-year는 추가로 year를 받아, 특정 연도의 진동을 계산해.
예시: life path
섹션 제목: “예시: life path”curl -X POST https://api.astroway.info/v1/numerology/pythagorean/life-path \ -H "X-Api-Key: aw_live_..." \ -H "Content-Type: application/json" \ -d '{"name":"Ada Lovelace","date":"1815-12-10"}'응답은 숫자뿐 아니라 전체 축소 과정과 준비된 해석을 포함해:
{ "ok": true, "data": { "system": "pythagorean", "name": "Ada Lovelace", "date": "1815-12-10", "lifePath": { "raw": 10, "reduced": 1, "isMaster": false, "steps": [10, 1], "meaning": { "number": 1, "archetype": "The Pioneer", "strengths": ["leadership", "independence", "innovation", "initiative"], "challenges": ["ego", "impatience", "isolation", "stubbornness"], "career": ["entrepreneur", "executive", "inventor", "pioneer"], "relationship": "needs a partner who respects independence; thrives on mutual challenge", "shortRead": "born to lead and originate; learn to balance solo drive with collaboration" } } }}steps 필드는 각 축소 단계(10 → 1)를 보여주고, isMaster는 11, 22, 33에서 활성화돼 - 피타고라스 학교 규칙에 따라 이들은 축소되지 않아. 직접 UI를 만들 때 중요해: 29가 11이 된 이유를 추측할 필요 없이 과정이 명시적으로 제공돼.
운명 매트릭스 별도
섹션 제목: “운명 매트릭스 별도”운명 매트릭스(Destiny Matrix)는 고전 수비학의 일부가 아니어서 자체 경로에서 제공돼:
POST /v1/destiny-matrix이 메서드는 출생일을 기반으로 22개의 메이저 타로 아르카나를 옥타그램으로 배치해. 중앙 십자가 위치, 조상 라인, 금전 구역, 관계 구역 등을 반환해 - 매트릭스 렌더링을 위한 준비된 구조야. /numerology/*와는 별도로 유지하는데, 이는 다른 모델(아르카나, 숫자 축소가 아님)이기 때문이야.
결정론에 관한 한 가지 상세
섹션 제목: “결정론에 관한 한 가지 상세”수비학 계산은 문자열과 날짜에 대한 순수 산수이며, 천문 데이터가 없어. 그래서 결정론적이고 저렴해: 같은 입력은 언제나 같은 출력을 내고, 캐싱이 간단해. 해석(meaning)은 정적 테이블이며 LLM이 아니기 때문에 환각도 없고 호출 간 변동성도 없어.
숫자 위에 자유 텍스트가 필요하면 AI가 있는 별도 레이어 /interpret/*를 사용하면 돼 - 하지만 기본 숫자는 언제나 결정론적인 코어에서 제공돼.
요금제
섹션 제목: “요금제”수비학은 타로, 룬, 지오맨티, I Ching과 함께 에소테릭 애드온 패키지에 포함돼. 각 호출은 고정된 크레딧 비용(계산용, AI 엔드포인트가 아니므로 저렴)이며, 무료 요금제는 월 10 000 크레딧을 제공해. 이는 비용 없이도 수백 명의 사용자를 위한 전체 수비학 프로필을 한 달에 수집하기에 충분해.
시작하기
섹션 제목: “시작하기”- 키는 dashboard/sign-up
- 대상 청중에 맞는 시스템을 선택해 (피타고라스식은 서구 시장 기본, 베다식은 인도 시장용)
- 10개의 호출로 프로필을 만들거나, 특정 화면을 위해 하나씩 숫자를 가져와
전체 필드와 스키마 목록은 OpenAPI‑довіднику의 Numerology 그룹에서 확인할 수 있어.
Solar Fire에 사용된 것과 동일한 Swiss Ephemeris - 단 4줄의 코드로.
카드 없이 무료 키. 첫 결제 전까지 월 5,000 API 호출.