Numerology 확장 + Horoscope 확장 v1.0.0 통합 변경 사항¶

전체 호로스코프 엔진 아키텍처

릴리스 날짜: 2026-04-12
버전: v1.0.0
범위: The Numerology API 및 Horoscope Expansion을 포함한 전체 플랫폼 릴리스: 확장된 엔드포인트 배포, 엔진 기반 호로스코프 보고서 마이그레이션, 요청/응답 정규화, 문서 일관성 유지, 다국어 유효성 검사 및 프로덕션 통합 지침 등을 포함합니다.

개요¶

v1.0.0은 Dakidarts API 플랫폼의 주요 프로덕션 릴리스입니다. 이 버전은 두 개의 큰 작업 영역을 하나의 조정된 배포로 통합합니다:

Numerology 확장
완전한 확장된 Numerology 인터페이스를 추가합니다.
개인 주 및 우주적 일/주/월/년과 함께 타이밍/사이클 커버리지를 확장합니다.
더 깊은 영적, 관계, 정체성 및 그림 분석 엔드포인트를 도입합니다.
완전한 문서 일관성, 응답 예제 및 다국어 유효성 검사를 완료합니다.2. 운세 확장
내부 Swiss Ephemeris 엔진으로 운세 보고 생성의 주요 마이그레이션을 완료합니다.
/api/v1/horoscope/reports/* 아래에서 엔진 기반 보고 경로를 표준화합니다.
매일, 주간, 월간 및 연간 기간에 걸쳐 광범위한 섹션 커버리지를 추가합니다.
기간별 행성, 관계, 이동 및 하우스 보고 세트를 도입합니다.
페이로드 일관성, 개인화 동작, 호환성 별칭 및 문서 일치성을 강화합니다.

이 변경 로그는 통합자, 내부 릴리스 검토, 지원, 마이그레이션 계획 및 고객 대상 릴리스 커뮤니케이션을 위한 단일 진실의 원천으로 사용하도록 설계되었습니다.

플랫폼 전체 주요 기능¶

v1.0.0이 플랫폼 전반에 제공하는 내용- 주요 v1.0.0 프로덕션 버전 (Numerology API 및 Horoscope API 모두)¶

Numerology 및 Horoscope 제품 전반에 걸쳐 엔드포인트 영역 확장.
주요 보고서 흐름에 대한 엔진 기반 호로скоп 계산 마이그레이션 완료.
Extended Numerology 릴리스 트랙 완료.
업그레이드된 호로скоп 라우트에 대한 POST 우선 구조화 요청 패턴 개선.
풍부한 응답 페이로드, 엔터프라이즈 래퍼 및 메타데이터 일관성을 위한 더 넓은 지원.
공용 문서 및 예제 페이로드에 걸쳐 강력한 문서 일치.
Numerology 확장 엔드포인트에 대한 성공적인 다국어 스모크 검증.
프로덕션 클라이언트에 대한 개선된 라우트 명확성, 호환성 처리 및 마이그레이션 지침.
출생 벡터 및 고급 요청 필드가 제공되는 경우 개인화된 계산 지원 확장.
호로скоп 요청 흐름에서 시간대, 별자리 시스템, 아야남사, 하우스 시스템 및 노드 동작에 대한 운영 명확성 개선.

릴리스 구성 요약¶

천문학 확장¶

새로운 엔드포인트 패밀리 추가: 23
결합된 작업 추가 (GET/POST): 41
유효성 검사/스모크 요청 실행: 205
다국어 스모크 성공 문서화: 100.0%
확장된 릴리스 모델: 추가적, 새로운 확장된 세트에서 공식적인 폐기 없음

천문학 확장¶

주요 보고서 인터페이스로 마이그레이션
다음 보고서 세트 추가:
행성
측면
트랜짓
하우스
행성-하우스
다음 엔드포인트 아래에서 /api/v1/horoscope/reports/* 하에 캐노니컬 보고서 네임스페이스 설정
여러 레거시 경로를 숨겨진 호환성 별칭으로 유지하면서 공공 문서가 캐노니컬 경로로 진행

제1부 — 천문학 API v1.0.0¶

천문학 확장 주요 내용- 확장된 Extended Numerology 표면을 확장된 문서 섹션에 따라 상세하게 설명했습니다.¶

완전한 GET/POST 기능을 포함하여 Personal Week를 추가하고 완료했으며, 풍부한 응답 페이로드 지원도 제공합니다.
다음 Universal Cycle 확장을 추가하고 완료했습니다:
Universal Day (일)
Universal Week (주)
Universal Month (월)
Universal Year (년)
완전한 매개변수 테이블, 옵션, 응답 예제 및 관련 엔드포인트 링크를 포함하여 표준화된 확장 엔드포인트 문서를 제공했습니다.
en, es, de, fr, pt에서 100% 성공으로 확장된 작업을 확인했습니다.
접근 모델을 명확히 했습니다: 확장 엔드포인트는 단일 플랫폼만 지원하며 현재 RapidAPI 게이트웨이를 통한 지원은 불가능합니다.

Numerology 확장 — 새로운 엔드포인트 추가¶

이 릴리스는 23개의 확장된 엔드포인트 패밀리와 41개의 작업(GET/POST를 합산)을 추가합니다.

A) 사이클 및 타임 엔드포인트| 엔드포인트 | 메서드 | 경로 |¶

|---|---|---| | 개인 주간 | GET, POST | /api/v1/personal-week | | 우주 연도 | GET, POST | /api/v1/universal-year | | 우주 월 | GET, POST | /api/v1/universal-month | | 우주 주 | GET, POST | /api/v1/universal-week | | 우주 일 | GET, POST | /api/v1/universal-day | | 월별 에너지 히트맵 | GET, POST | /api/v1/monthly-energy-heatmap | | 주의 날짜 달력 | GET, POST | /api/v1/caution-dates-calendar |

B) 정체성 및 이름 지능 엔드포인트¶

엔드포인트	메서드	경로
사용자 이름 번호학	`GET`, `POST`	`/api/v1/username-numerology`
사업체 이름 번호학	`GET`, `POST`	`/api/v1/business-name-numerology`
브랜드 이름 비교	`POST`	`/api/v1/brand-name-compare`
이름 변경 영향	`GET`, `POST`	`/api/v1/name-change-impact`
날짜 일치 확인	`GET`, `POST`	`/api/v1/date-alignment-check`

C) 영적 및 그림 분석 엔드포인트| 엔드포인트 | 메서드 | 경로 |¶

|---|---|---| | 오라 주파수 판독 | GET, POST | /api/v1/aura-frequency-reading | | 차크라 숫자학 | GET, POST | /api/v1/chakra-numerology | | 과거 삶의 패턴 | GET, POST | /api/v1/past-life-patterns | | 그림자 작업 숫자 | GET, POST | /api/v1/shadow-work-number | | 영혼 계약 판독 | GET, POST | /api/v1/soul-contract-reading | | 영혼 연결 지표 | POST | /api/v1/soul-connection-indicator | | 영적 선물 판독 | GET, POST | /api/v1/spiritual-gifts-reading | | 신성한 균형 판독 | GET, POST | /api/v1/sacred-balance-reading |

D) 관계 역학 엔드포인트¶

엔드포인트	메서드	경로
관계 종합	`POST`	`/api/v1/relationship-composite`
관계 치유 판독	`POST`	`/api/v1/relationship-healing-reading`
부모 자녀 숫자학	`POST`	`/api/v1/parent-child-numerology`

Numerology API — 업데이트 및 수정된 엔드포인트¶

A) 새로 완료된 핵심 확장 인터페이스¶

다음과 같이 이 릴리스 주기에 걸쳐 요청 유효성 검사 및 풍부한 의미 출력으로 전체적으로 완료되었습니다.

GET /api/v1/personal-week
POST /api/v1/personal-week
GET /api/v1/universal-year
POST /api/v1/universal-year
GET /api/v1/universal-month
POST /api/v1/universal-month
GET /api/v1/universal-week
POST /api/v1/universal-week
GET /api/v1/universal-day
POST /api/v1/universal-day### B) 스모크 검증 시 적용된 안정성 수정 사항

초기 생성된 스모크 입력에서 422를 반환하는 다섯 가지 작업이 프로덕션과 유사한 테스트 입력 커버리지를 위해 안정화되었으며, 이제 다국어 스모크에서 성공적인 응답을 반환합니다:

POST /api/v1/brand-name-compare
GET /api/v1/caution-dates-calendar
POST /api/v1/caution-dates-calendar
GET /api/v1/monthly-energy-heatmap
POST /api/v1/monthly-energy-heatmap

C) 실질적인 검증 규칙 강화¶

검증 및 문서화 작업 중에 다음 제약 조건이 강화되고 명확해졌습니다:

브랜드 비교는 names[]에 최소 두 개의 항목을 필요로 합니다.
달력 및 히트맵 월 입력은 YYYY-MM 형식을 사용합니다.
경고 날짜 top_n는 범위 1..31 내로 제한됩니다.
클라이언트 페이로드에는 제출 전에 사전 검증을 통해 불필요한 422 또는 형식 수준 오류를 줄이는 데 도움이 됩니다.

D) 문서 및 OpenAPI 동기화 수정 사항¶

모든 확장된 문서를 통합 동기화를 위해 표준화했습니다:

각 메서드에 대한 완전한 매개변수 테이블
매개변수 옵션 세부 정보
패턴, 범위, 기본값 및 중첩 객체 필드
스모크 생성 페이로드를 기반으로 한 풍부한 응답 예제 섹션
표준화된 접근 및 가용성 노트
대시보드 CTA, 노트 섹션 및 관련 엔드포인트 푸터## Numerology API – QA 검증 결과 요약

확장된 Numerology 기능 세트에 대한 검증 결과:

요약 파일: 23개
테스트된 작업: 41개
실행된 총 요청 수: 205건
전체 성공률: 100.0%
언어별 성공률:
en – 100%
es – 100%
de – 100%
fr – 100%
pt – 100%

이번 릴리스는 문서화된 언어 세트에 대한 생산 환경에서 검증 가능한 신뢰를 제공하여 확장된 Numerology 기능 출시 주기를 완료합니다.

Numerology API – 폐기될 기능¶

Numerology Extended v1.0.0 릴리스에서는 확장된 인터페이스의 특정 엔드포인트가 공식적으로 폐기되지 않습니다.

엔드포인트	v1.0.0에서의 상태	대체	참고 사항
없음	해당 없음	해당 없음	이번 릴리스에서 확장된 기능은 추가적인 기능입니다.

Numerology API – 변경될 기능¶

이번 릴리스에서는 확장된 Numerology 인터페이스에 대한 경로 제거가 도입되지 않습니다.

하지만, 통합자는 다음 배포 수준의 기대 사항을 염두에 두어야 합니다:- 확장된 엔드포인트는 현재 RapidAPI를 통해 사용되지 않습니다. - 확장된 엔드포인트를 통합하는 클라이언트는 직접 플랫폼 호스트를 대상으로 해야 합니다. - 일부 새로운 엔드포인트는 설계상 POST만 지원하며, GET와 동일한 기능을 갖는 것으로 가정할 수 없습니다.

Numerology API — 마이그레이션 노트¶

1) 액세스 채널 마이그레이션¶

확장된 엔드포인트는 직접 플랫폼 액세스를 통해 사용할 수 있습니다:

기본 URL: https://api.numerologyapi.com
인증:
X-API-Key: YOUR_API_KEY
또는 Authorization: Bearer YOUR_API_KEY

확장된 엔드포인트는 현재 RapidAPI 게이트웨이를 통해 지원되지 않습니다.

2) GET vs POST 사용 지침¶

대부분의 확장된 엔드포인트는 GET 및 POST을 모두 지원하며, 동일한 출력 의도를 가집니다.

사용:

GET를 사용하여 간단한 쿼리 기반 호출
POST를 사용하여 강력한 페이로드 구조, 중첩된 객체 및 SDK/백엔드 일관성을 유지

이 릴리스의 포스트만 지원하는 엔드포인트는 다음과 같습니다:

/api/v1/brand-name-compare
/api/v1/relationship-composite
/api/v1/relationship-healing-reading
/api/v1/parent-child-numerology
/api/v1/soul-connection-indicator

3) 클라이언트 측 입력 유효성 검사 규칙¶

권장되는 클라이언트 측 사전 유효성 검사를 수행하십시오:- dob 및 target_date: YYYY-MM-DD - month: YYYY-MM - timezone_offset: 유효한 IANA 시간대 문자열 - top_n: 1..31 범위 내의 정수 - names[]: 브랜드 비교에 필요한 최소 항목은 2개 - context (날짜 일치): 최대 길이 80, 정상화된 별칭 사용 가능

4) 중첩 요청 본문 패턴¶

관계 및 호환성 엔드포인트의 경우, 다음 형식의 명시적인 중첩 객체를 사용하십시오:

person_a
person_b
parent
child

각 객체는 다음 필수 필드를 포함해야 합니다:

full_name
dob

5) 언어 및 메타데이터 처리¶

확장된 수기 엔드포인트는 lang를 통해 다국어 응답 렌더링을 지원합니다.

스모크 검증된 커버리지에 대한 지원되는 언어 세트:

en
es
de
fr
pt

응답에는 엔터프라이즈 스타일의 메타데이터 래퍼가 포함될 수 있습니다:

_enterprise
_api_metadata_

클라이언트는 플랫폼 분석, 계획 정보 또는 엔드포인트 메타데이터에 유용한 경우 이러한 필드를 보존하고 파싱해야 합니다.

6) 새로 추가된 사이클 커버리지¶

개인적인 날/월/년 흐름만 사용하던 클라이언트는 이제 다음을 포함하도록 스케줄 로직을 확장할 수 있습니다:- 주간 개인 주기 관련 정보 (/api/v1/personal-week) - 집단적 타이밍 표면 관련 정보: - /api/v1/universal-day - /api/v1/universal-week - /api/v1/universal-month - /api/v1/universal-year

7) 핵심 문서 정보¶

이 버전의 전체 엔드포인트 수준 통합 페이지는 인덱스와 개별 엔드포인트 페이지를 포함한 확장된 문서 섹션에서 유지 관리됩니다.

Numerology API — 권장 업그레이드 체크리스트¶

https://api.numerologyapi.com 에서 확장된 호출을 직접 API 액세스로 이동합니다.
요청 검증기가 날짜, 월 및 시간대를 형식으로 적용되도록 합니다.
필요한 경우 다국어 lang 값에 대한 대체 처리를 추가합니다.
_enterprise 및 _api_metadata_ 를 일관성 있게 파싱하도록 클라이언트를 업데이트합니다.
중첩된 엔드포인트의 경우, SDK 요청 모델을 필요한 객체 키에 맞춰 조정합니다.
프로덕션으로 전송하기 전에 스모크 테스트를 통과합니다.
모든 확장된 호출이 RapidAPI 기반 클라이언트 가정 외부로 라우팅되는지 확인합니다.

Numerology API — 릴리스 노트 요약¶

Numerology API v1.0.0은 주간 및 보편적인 주기 확장에 더불어, 고급 관계 및 영적 분석, 풍부한 요청/응답 계약, 그리고 완벽하게 동기화된 문서와 스모크 테스트 호환성을 포함하는 완전한 확장된 Numerology 표면을 소개합니다.# 제2부 — 호주로 확장 v1.0.0

호주로 확장의 주요 기능¶

자체 개발한 Swiss Ephemeris 엔진으로 주요 호주로 보고서 흐름 마이그레이션 완료.
POST 요청 본문을 중심으로 업그레이드된 표준 보고서 엔드포인트 구현.
일일, 주간, 월간 및 연간 기간에 걸쳐 광범위한 섹션 우선 커버리지 제공.
기간 및 섹션/개요의 균형을 맞추어 행성 보고서 엔드포인트를 재구성.
보고서 동작 대신 정보적 동작을 반영하도록 행성 어휘 엔드포인트 이름을 변경.
출생 차트 요청의 일관성을 확장하고 응답 형상 유효성 검사를 강화.
업그레이드된 엔드포인트 응답을 엔진 페이로드와 기업 메타데이터 래퍼를 포함하도록 표준화.
스모크 기반 JSON과의 일관성을 갖는 공개 문서 예제를 업데이트.

호주로 확장 — 추가된 엔드포인트¶

A) 새로운 헬퍼 및 카나니얼 서피스¶

GET /api/v1/horoscope/timezones

B) 행성 보고서 세트 (기간별 서피스)¶

섹션 (일반적 아님):

POST /api/v1/horoscope/reports/planetary/daily
POST /api/v1/horoscope/reports/planetary/weekly
POST /api/v1/horoscope/reports/planetary/monthly
POST /api/v1/horoscope/reports/planetary/yearly

개요 (일반적):

POST /api/v1/horoscope/reports/planetary/daily/overview
POST /api/v1/horoscope/reports/planetary/weekly/overview
POST /api/v1/horoscope/reports/planetary/monthly/overview
POST /api/v1/horoscope/reports/planetary/yearly/overview

기간에 걸쳐 확장된 행성 섹션 커버리지는 다음과 같은 엔진 지원 섹션을 포함합니다:- communication - friendship - lifestyle - career - health - money - love_singles - love_couples

C) Aspect 보고서 세트 (기간별 표면)¶

섹션 (일반적인 것이 아님):

POST /api/v1/horoscope/reports/aspects/daily
POST /api/v1/horoscope/reports/aspects/weekly
POST /api/v1/horoscope/reports/aspects/monthly
POST /api/v1/horoscope/reports/aspects/yearly

개요 (일반적인 경우):

POST /api/v1/horoscope/reports/aspects/daily/overview
POST /api/v1/horoscope/reports/aspects/weekly/overview
POST /api/v1/horoscope/reports/aspects/monthly/overview
POST /api/v1/horoscope/reports/aspects/yearly/overview

aspects/*를 지원합니다:

공개 모드
개인화된 모드
선택적인 결정론적 aspect 재정의
업그레이드된 호르스코프 경로에서 사용되는 동일한 섹션 모델

D) 트랜짓 보고서 세트 (기간별 표면)¶

섹션 (일반적인 것이 아님):

POST /api/v1/horoscope/reports/transits/daily
POST /api/v1/horoscope/reports/transits/weekly
POST /api/v1/horoscope/reports/transits/monthly
POST /api/v1/horoscope/reports/transits/yearly

개요 (일반적인 경우):

POST /api/v1/horoscope/reports/transits/daily/overview
POST /api/v1/horoscope/reports/transits/weekly/overview
POST /api/v1/horoscope/reports/transits/monthly/overview
POST /api/v1/horoscope/reports/transits/yearly/overview

transits/*를 지원합니다:

공개 모드
개인화된 모드
선택적인 결정론적 transit 재정의
업그레이드된 호르스코프 경로에서 사용되는 동일한 섹션 모델

E) 하우스 보고서 세트 (개인용, 기간별 표면)¶

하우스 보고서 (일반적인 것이 아닌 섹션):

POST /api/v1/horoscope/reports/house/daily
POST /api/v1/horoscope/reports/house/weekly
POST /api/v1/horoscope/reports/house/monthly
POST /api/v1/horoscope/reports/house/yearly

하우스 개요 (일반적인 경우):

POST /api/v1/horoscope/reports/house/daily/overview
POST /api/v1/horoscope/reports/house/weekly/overview
POST /api/v1/horoscope/reports/house/monthly/overview
POST /api/v1/horoscope/reports/house/yearly/overview

행성-하우스 보고서 (일반적인 것이 아닌 섹션):

POST /api/v1/horoscope/reports/planet/house/daily
POST /api/v1/horoscope/reports/planet/house/weekly
POST /api/v1/horoscope/reports/planet/house/monthly
POST /api/v1/horoscope/reports/planet/house/yearly일반적인 별자리 및 주별 개요:

POST /api/v1/horoscope/reports/planet/house/daily/overview
POST /api/v1/horoscope/reports/planet/house/weekly/overview
POST /api/v1/horoscope/reports/planet/house/monthly/overview
POST /api/v1/horoscope/reports/planet/house/yearly/overview

두 가지 라우트 패밀리는 개인화만 가능하며, 다음과 같은 엔진 엔드포인트에 의해 지원됩니다: - /house-horoscope - /planet-house-horoscope

F) 보고서 네임스페이스 표준화¶

Canonical live-report paths now use the /api/v1/horoscope/reports/* namespace across upgraded engine-backed horoscope surfaces.

Legacy non-report paths remain registered as hidden compatibility aliases.

G) 새로운 별자리 섹션 경로 가족 (기간별)¶

커뮤니케이션¶

POST /api/v1/horoscope/reports/communication/daily/today
POST /api/v1/horoscope/reports/communication/daily/tomorrow
POST /api/v1/horoscope/reports/communication/daily/yesterday
POST /api/v1/horoscope/reports/communication/weekly
POST /api/v1/horoscope/reports/communication/monthly
POST /api/v1/horoscope/reports/communication/yearly

우정¶

POST /api/v1/horoscope/reports/friendship/daily/today
POST /api/v1/horoscope/reports/friendship/daily/tomorrow
POST /api/v1/horoscope/reports/friendship/daily/yesterday
POST /api/v1/horoscope/reports/friendship/weekly
POST /api/v1/horoscope/reports/friendship/monthly
POST /api/v1/horoscope/reports/friendship/yearly

라이프스타일¶

POST /api/v1/horoscope/reports/lifestyle/daily/today
POST /api/v1/horoscope/reports/lifestyle/daily/tomorrow
POST /api/v1/horoscope/reports/lifestyle/daily/yesterday
POST /api/v1/horoscope/reports/lifestyle/weekly
POST /api/v1/horoscope/reports/lifestyle/monthly
POST /api/v1/horoscope/reports/lifestyle/yearly

사랑의 분열: 솔로/커플¶

POST /api/v1/horoscope/reports/love_singles/daily/today
POST /api/v1/horoscope/reports/love_singles/daily/tomorrow
POST /api/v1/horoscope/reports/love_singles/daily/yesterday
POST /api/v1/horoscope/reports/love_singles/weekly
POST /api/v1/horoscope/reports/love_singles/monthly
POST /api/v1/horoscope/reports/love_couples/daily/today
POST /api/v1/horoscope/reports/love_couples/daily/tomorrow
POST /api/v1/horoscope/reports/love_couples/daily/yesterday
POST /api/v1/horoscope/reports/love_couples/weekly
POST /api/v1/horoscope/reports/love_couples/monthly

연간 섹션 추가¶

POST /api/v1/horoscope/reports/health/yearly
POST /api/v1/horoscope/reports/money/yearly

H) 이름 변경된 정보 행성 표면¶

GET /api/v1/horoscope/planets-info
POST /api/v1/horoscope/planets-info

이것은 정보 제공용 어휘 목록 스타일의 이전 명명 방식인 `/horoscope/planets`을 대체합니다.¶

운성 확장 - 업데이트 및 수정된 엔드포인트¶

A) 엔진 마이그레이션 및 동작 업데이트¶

다음 기존 라우트 패밀리가 자체 엔진 기반 동작으로 업그레이드되었습니다.

주요 보고서 라우트¶

POST /api/v1/horoscope/reports/today
POST /api/v1/horoscope/reports/yesterday
POST /api/v1/horoscope/reports/tomorrow
POST /api/v1/horoscope/reports/weekly
POST /api/v1/horoscope/reports/monthly
POST /api/v1/horoscope/reports/yearly

기존 카테고리 라우트가 legacy horoscope.com 기반 동작에서 업그레이드됨¶

경력
건강
사랑
돈

기존 및 legacy 패밀리가 재구성 및 업그레이드됨¶

legacy love 라우트가 love_singles 및 love_couples로 분할
yearly/career_money 동작이 전용 연간 경력 및 연간 돈 라우트로 대체
행성 legacy 보고서 및 개요 라우트가 주기화된 라우트로 이동

B) 별자리 신호 설명 라우트 명확화¶

다음 표면은 여전히 라이브 보고서 엔드포인트가 아닌 설명적인 신호 엔드포인트로 남아 있습니다.

/api/v1/horoscope/sign/personality
/api/v1/horoscope/sign/communication
/api/v1/horoscope/sign/friendship
/api/v1/horoscope/sign/love
/api/v1/horoscope/sign/lifestyle
/api/v1/horoscope/sign/health
/api/v1/horoscope/sign/career
/api/v1/horoscope/sign/money
/api/v1/horoscope/sign/parent_child
/api/v1/horoscope/sign/spirituality
/api/v1/horoscope/sign/shadow

C) 생일 운성 동기화 업데이트¶

POST /api/v1/horoscope/reports/birthday는 자체 엔진 기반 요청 키를 노출하면서도 호환성을 유지합니다.

표준화된 업그레이드된 표면:

POST /api/v1/horoscope/reports/birthday

숨겨진 호환성 별칭은 유지됩니다.- /api/v1/horoscope/birthday - /api/v1/horoscope/sign/birthday

다음 엔진 기반 요청 키가 노출됨:

sign
target_date
birth
sections
zodiac_system
ayanamsa
house_system
node_type
tenant_id

호환성 키 유지:

dob
timezone
year
birth_time
birth_latitude
birth_longitude
birth_timezone

D) 탄생 시 생명 차트 동기화 업데이트¶

이 기능은 v1.0.0 이전부터 존재했으며, 이제 엔진과의 완전한 호환성을 위해 업그레이드되었습니다:

POST /api/v1/birth-chart
POST /api/v1/birth-chart/svg

개선 사항에는 다음이 포함됩니다:

게이트웨이를 통해 엔진으로의 요청 옵션 지원 강화
휠 구성 필드의 호환성 유지
응답 형태 검사 강화

E) 응답 계약 정규화¶

업그레이드된 호르스코프 엔진 기반 엔드포인트는 다음을 반환합니다:

원시 엔진 응답 페이로드
_enterprise
_api_metadata_

F) 시간대 및 상대 날짜 처리¶

today, yesterday, 및 tomorrow를 사용하는 일일 엔드포인트는 IANA 시간대를 사용하여 대상 날짜를 해결합니다.

G) 개인화 지원 명확화¶

지원되는 경우, 다음 출생 벡터 필드를 제공하여 개인화된 보고서를 활성화할 수 있습니다:

birth_time
birth_latitude
birth_longitude
birth_timezone

필드가 제공되지 않으면, 해당 경로가 일반적인 부호 기반 모드로도 사용 가능합니다.## 호주소 확장 - 폐기된, 숨겨진 및 제거된 엔드포인트| 엔드포인트 | v1.0.0 버전 상태 | 대체 | 참고 사항 | |---|---|---|---| | Legacy 행성 종합 보고서 경로 | 제거 | /reports/planetary/ 아래 기간별 경로와 일치하는 /overview 경로를 포함한 기간 기반 경로 | 기간 기반 동기화 완료 후 종합 엔트리포인트 제거. | | POST /api/v1/horoscope/planetary/overview | 폐기됨 (OpenAPI에서 숨김) | POST /api/v1/horoscope/reports/planetary/daily/overview, POST /api/v1/horoscope/reports/planetary/weekly/overview, POST /api/v1/horoscope/reports/planetary/monthly/overview, POST /api/v1/horoscope/reports/planetary/yearly/overview | 기간별 개요 경로로 대체. | | POST /api/v1/horoscope/planetary/daily/sections | 숨겨진 별칭 | POST /api/v1/horoscope/reports/planetary/daily | 내부 호환성 별칭. | | POST /api/v1/horoscope/love_single/monthly | 폐기된 별칭 (숨김) | POST /api/v1/horoscope/reports/love_singles/monthly | 호환성을 위해 유지. | | POST /api/v1/horoscope/weekly/retail | 폐기됨 (OpenAPI/문서에서 숨김) | 없음 | 공공 문서에서 주간 소매 표면이 제거됨. | | Legacy 유연한 종합 운세 경로 | 제거 | 섹션별 보고서 경로 및 기간 개요 경로 | 엔드포인트 분할 후 종합 엔트리포인트 제거. | | POST /api/v1/horoscope/yearly/career_money | 제거됨 | POST /api/v1/horoscope/reports/career/yearly 및 POST /api/v1/horoscope/reports/money/yearly | 결합된 엔드포인트를 개별 경로로 분할. | | POST /api/v1/horoscope/love/{today,tomorrow,yesterday} | 비활성 등록 제거 | POST /api/v1/horoscope/reports/love_singles/daily/{today,tomorrow,yesterday} 또는 POST /api/v1/horoscope/reports/love_couples/daily/{today,tomorrow,yesterday} | 매일의 사랑이 이제 관계 맥락에 따라 분리됨. || GET /api/v1/horoscope/planets 및 POST /api/v1/horoscope/planets | 이름 변경/제거 | GET /api/v1/horoscope/planets-info 및 POST /api/v1/horoscope/planets-info | 명확성을 위한 정보 엔드포인트 이름 변경 |

별자리 확장 — 호환성 문제¶

경로 이름 변경: /api/v1/horoscope/planets → /api/v1/horoscope/planets-info
실시간 엔진 기반 별자리 보고서의 표준 네임스페이스는 이제 /api/v1/horoscope/reports/* 입니다.
결합된 일별 사랑 경로는 명확한 싱글 및 커플 경로로 대체되었습니다.
결합된 연간 career_money 경로는 대신 전용 연간 경로를 사용합니다.
일반적인 행성 보고서 및 개요 엔드포인트를 기간 기반 경로로 대체했습니다.
POST 요청 본문이 우선시되는 방식으로 업그레이드된 엔진 기반 경로는 표준화되었습니다.

별자리 확장 — 호환성 노트¶

기존 /api/v1/horoscope/report/* 경로는 숨겨진 후방 호환 가능한 별칭으로 계속 사용 가능합니다.
공개 문서 및 OpenAPI는 이제 표준 /api/v1/horoscope/reports/* 네임스페이스만 제공합니다.
새로운 통합은 즉시 /reports/* 경로를 채택해야 합니다.

별자리 확장 — 마이그레이션 노트¶

1) 엔드포인트 경로 마이그레이션 매핑- `GET/POST /api/v1/horoscope/planets` → `GET/POST /api/v1/horoscope/planets-info`¶

POST /api/v1/horoscope/report/{surface} → POST /api/v1/horoscope/reports/{surface}
POST /api/v1/horoscope/{surface} → POST /api/v1/horoscope/reports/{surface}
POST /api/v1/horoscope/planetary/overview → POST /api/v1/horoscope/reports/planetary/{period}/overview
기존 행성 기반 집계 경로: POST /api/v1/horoscope/reports/planetary/{period} 또는 해당 개요 경로 사용
기존 유연한 행성 기반 운세 경로: 섹션별 경로 또는 해당 개요 경로 사용
POST /api/v1/horoscope/yearly/career_money → 연간 경력 및 연간 소득 관련 경로로 분할
기존 사랑 일일 경로: love_singles 또는 love_couples 일일 경로로 분할

2) 요청 페이로드 마이그레이션¶

업그레이드된 엔진 기반 경로의 경우, 다음 필드를 포함하는 구조화된 POST 본문을 사용하십시오:

dob
timezone
기간 선택자 (예: day, target_date 또는 year)
선택적 엔진 옵션:
zodiac_system
ayanamsa
house_system
node_type
tenant_id
선택적 개인화 필드:
birth_time
birth_latitude
birth_longitude
birth_timezone

3) 행성 경로 마이그레이션 규칙¶

개요가 아닌 행성 기간 경로에만 sections 사용
general는 전용 /overview 경로를 통해 접근 가능

4) 응답 파서 마이그레이션¶

클라이언트는 다음을 파싱해야 합니다:

보고 페이로드 필드를 응답 본체에서 직접 추출
_enterprise
_api_metadata_

5) 번역 관련 참고 사항직접적인 다국어 콘텐츠 생성을 위한 호주소 엔진 자체는 기능을 제공하지 않으므로, 현재 보고 기반 엔드포인트는 `en`만 지원합니다.¶

Non-report endpoints continue to support full multilingual translation through gateway helper layers using lang, such as:

en
es
de
fr
pt

호주럽 확장 - 문서 및 품질 보증 일치 완료¶

공개 문서가 업그레이드된 호주로 경로에 맞춰 업데이트됨

---- 이전 시대의 행성 관련 문서가 특정 시기에 맞는 행성 관련 문서로 대체됨

---- 경력 및 재정 관련 문서 분리 (병합된 경로 제거)

---- 업그레이드된 문서에 맞춰 엔드포인트 응답과 동기화된 "스모크" 기반 예제 JSON¶

호주럽 확장 - 권장 클라이언트 업그레이드 체크리스트¶

이름이 변경되거나 폐기된 모든 경로를 마이그레이션 매핑을 사용하여 업데이트합니다.- 업그레이드된 보고서 경로를 사용하는 기존 GET 클라이언트를 POST 요청으로 전환합니다.- 모든 일일 흐름에 시간대를 추가하여 상대적인 날짜 차이를 방지합니다.- 사용자별 맞춤 편집이 필요한 경우, 개인화 필드를 추가하십시오

---- 응답 파서 업데이트를 통해 _enterprise 및 _api_metadata_ 유지- 프로덕션 환경에서 사용되는 모든 호주로 엔드포인트에 대해 재실행 통합 테스트

---¶

호주소 확장 — 릴리스 노트 요약¶

Numerology API v1.0.0은 주요 엔진과의 동기화를 완료하고, 보고서 범위를 섹션 및 기간별로 확장하며, 더 깔끔한 표준 경로 구조를 도입하고, 내부 호주소 엔진의 향후 버전을 위한 명확한 프로덕션 인터페이스를 확립합니다.

제3부 — 클라이언트 대상 API 통합 지침¶

Numerology API를 사용하는 클라이언트를 위한 통합 노트¶

Numerology 엔드포인트와 호주소 엔드포인트를 모두 소비하는 클라이언트는 다음을 함께 검토해야 합니다:

인증 및 접근¶

확장된 Numerology 엔드포인트는 RapidAPI 게이트웨이 지원 없이 플랫폼 내에서만 사용 가능합니다.
엔진 기반 호주소 경로도 RapidAPI 게이트웨이를 사용하여 업그레이드된 패턴으로 계속 사용되며, 자체 API 네임스페이스를 유지합니다.
기업 스타일의 메타데이터 래퍼에 대한 지원을 유지하십시오.

요청 모델링¶

모든 새로 업그레이드되거나 확장된 경로에 대해 명시적인 구조화된 POST 본문을 선호하십시오.
날짜 형식, 기간 선택기, 시간대 문자열 및 중첩된 객체를 클라이언트 측에서 유효성 검사하십시오.
사용할 수 있는 경우, 풍부한 출력을 위한 개인화 벡터를 제공하십시오.### 시간대 및 날짜 의미론
Numerology 엔드포인트는 올바른 날짜 및 월 형식에 의존합니다.
Horoscope 일별 경로가 상대적 날짜 해결을 위한 올바른 시간대 처리에 의존합니다.
IANA 시간대 문자열은 지원되는 경우 강력하게 권장됩니다.

언어 처리¶

Numerology 확장 엔드포인트는 실험적으로 검증된 다국어 렌더링을 제공합니다.
Engine 기반 Horoscope 경로가 en만 계속 지원합니다.

프로덕션 배포 권장 사항¶

먼저 SDK 및 요청 유효성 검사기를 업데이트하십시오.
두 번째로 통합 테스트를 새로 고칩니다.
그런 다음 경로/경로 변경을 프로덕션 클라이언트로 홍보합니다.
내부적으로 여전히 사용 중인 모든 숨겨진 호환성 별칭을 모니터링하여 나중에 자신 있게 폐기할 수 있도록 합니다.

제4장 — 최종 릴리스 요약¶

v1.0.0의 의미¶

v1.0.0은 두 가지 표면이 모두 상당히 완전하고 프로덕션에 적합한 상태가 되는 지점입니다:- Numerology API는 이제 시간, 정체성, 영적 통찰력, 그림자 작업, 관계, 호환성 및 예측 달력을 포함한 훨씬 더 풍부하고 확장된 카탈로그를 제공합니다. - 운세 보고서는 이제 표준 보고서 네임스페이스, 더 넓은 섹션 커버리지, 명확한 마이그레이션 패턴 및 보고서 가족 간의 더 나은 호환성을 갖춘 강력한 엔진 기반으로 구축되었습니다. - 문서, 예제, 유효성 검사 동작 및 호환성 지침은 1.0.0 이전 상태보다 훨씬 성숙합니다.

이번 릴리스는 단순 버전 업그레이드 이상입니다. 다음을 개선하는 구조적인 릴리스입니다.

플랫폼 완성도
경로 명확성
클라이언트 마이그레이션 준비성
문서 신뢰도
엔터프라이즈 통합 일관성

운영 권장 사항¶

모든 활성 통합자에게는 다음과 같은 경로가 권장됩니다.

표준 경로는 즉시 채택하십시오.
POST 요청에 대한 페이로드의 경우 해당되는 경우 요청 모델을 업데이트하십시오.
메타데이터 래퍼 파싱을 유지하십시오.
클라이언트 측에서 시간대/날짜 형식을 유효성 검사하십시오.
Numerology 확장 소비자에게 직접 플랫폼 액세스를 제공하십시오.
프로덕션 배포 전에 전체 통합 스모크 커버리 재실행

마무리 노트This unified changelog reflects the v1.0.0 release state for The Numerology API and consolidates the major rollout work completed for the 2026-04-12 release window.¶

Numerology 확장 + Horoscope 확장 v1.0.0 통합 변경 사항¶

개요¶

플랫폼 전체 주요 기능¶

v1.0.0이 플랫폼 전반에 제공하는 내용- 주요 v1.0.0 프로덕션 버전 (Numerology API 및 Horoscope API 모두)¶

릴리스 구성 요약¶

천문학 확장¶

천문학 확장¶

제1부 — 천문학 API v1.0.0¶

천문학 확장 주요 내용- 확장된 Extended Numerology 표면을 확장된 문서 섹션에 따라 상세하게 설명했습니다.¶

Numerology 확장 — 새로운 엔드포인트 추가¶

A) 사이클 및 타임 엔드포인트| 엔드포인트 | 메서드 | 경로 |¶

B) 정체성 및 이름 지능 엔드포인트¶

C) 영적 및 그림 분석 엔드포인트| 엔드포인트 | 메서드 | 경로 |¶

D) 관계 역학 엔드포인트¶

Numerology API — 업데이트 및 수정된 엔드포인트¶

A) 새로 완료된 핵심 확장 인터페이스¶

C) 실질적인 검증 규칙 강화¶

D) 문서 및 OpenAPI 동기화 수정 사항¶

Numerology API – 폐기될 기능¶

Numerology API – 변경될 기능¶

Numerology API — 마이그레이션 노트¶

1) 액세스 채널 마이그레이션¶

2) GET vs POST 사용 지침¶

3) 클라이언트 측 입력 유효성 검사 규칙¶

4) 중첩 요청 본문 패턴¶

5) 언어 및 메타데이터 처리¶

6) 새로 추가된 사이클 커버리지¶

7) 핵심 문서 정보¶

Numerology API — 권장 업그레이드 체크리스트¶

Numerology API — 릴리스 노트 요약¶

호주로 확장의 주요 기능¶

호주로 확장 — 추가된 엔드포인트¶

A) 새로운 헬퍼 및 카나니얼 서피스¶

B) 행성 보고서 세트 (기간별 서피스)¶

C) Aspect 보고서 세트 (기간별 표면)¶

D) 트랜짓 보고서 세트 (기간별 표면)¶

E) 하우스 보고서 세트 (개인용, 기간별 표면)¶

F) 보고서 네임스페이스 표준화¶

G) 새로운 별자리 섹션 경로 가족 (기간별)¶

커뮤니케이션¶

우정¶

라이프스타일¶

사랑의 분열: 솔로/커플¶

연간 섹션 추가¶

H) 이름 변경된 정보 행성 표면¶

이것은 정보 제공용 어휘 목록 스타일의 이전 명명 방식인 /horoscope/planets을 대체합니다.¶

운성 확장 - 업데이트 및 수정된 엔드포인트¶

A) 엔진 마이그레이션 및 동작 업데이트¶

주요 보고서 라우트¶

기존 카테고리 라우트가 legacy horoscope.com 기반 동작에서 업그레이드됨¶

기존 및 legacy 패밀리가 재구성 및 업그레이드됨¶

B) 별자리 신호 설명 라우트 명확화¶

C) 생일 운성 동기화 업데이트¶

D) 탄생 시 생명 차트 동기화 업데이트¶

E) 응답 계약 정규화¶

F) 시간대 및 상대 날짜 처리¶

G) 개인화 지원 명확화¶

별자리 확장 — 호환성 문제¶

별자리 확장 — 호환성 노트¶

별자리 확장 — 마이그레이션 노트¶

1) 엔드포인트 경로 마이그레이션 매핑- GET/POST /api/v1/horoscope/planets → GET/POST /api/v1/horoscope/planets-info¶

2) 요청 페이로드 마이그레이션¶

3) 행성 경로 마이그레이션 규칙¶

4) 응답 파서 마이그레이션¶

5) 번역 관련 참고 사항직접적인 다국어 콘텐츠 생성을 위한 호주소 엔진 자체는 기능을 제공하지 않으므로, 현재 보고 기반 엔드포인트는 en만 지원합니다.¶

호주럽 확장 - 문서 및 품질 보증 일치 완료¶

---- 업그레이드된 문서에 맞춰 엔드포인트 응답과 동기화된 "스모크" 기반 예제 JSON¶

호주럽 확장 - 권장 클라이언트 업그레이드 체크리스트¶

---¶

호주소 확장 — 릴리스 노트 요약¶

제3부 — 클라이언트 대상 API 통합 지침¶

Numerology API를 사용하는 클라이언트를 위한 통합 노트¶

인증 및 접근¶

요청 모델링¶

언어 처리¶

프로덕션 배포 권장 사항¶

제4장 — 최종 릴리스 요약¶

v1.0.0의 의미¶

운영 권장 사항¶

마무리 노트This unified changelog reflects the v1.0.0 release state for The Numerology API and consolidates the major rollout work completed for the 2026-04-12 release window.¶

이것은 정보 제공용 어휘 목록 스타일의 이전 명명 방식인 `/horoscope/planets`을 대체합니다.¶

1) 엔드포인트 경로 마이그레이션 매핑- `GET/POST /api/v1/horoscope/planets` → `GET/POST /api/v1/horoscope/planets-info`¶

5) 번역 관련 참고 사항직접적인 다국어 콘텐츠 생성을 위한 호주소 엔진 자체는 기능을 제공하지 않으므로, 현재 보고 기반 엔드포인트는 `en`만 지원합니다.¶