호주소 보고서 API 개요¶

생산 환경에 적합한, 스위스 에페메리스 기반의 결정론적 엔진을 사용하여 천문학 제품을 구축합니다.

이 API는 다음과 같은 두 가지 고가치 보고서 모드를 지원합니다.

Public mode: 안정적인 신호 기반의 대규모 출력
Personalized mode: 출생 데이터에 대한 인지 편집 보고서 (더 깊은 벡터, 하우스, 측면, 타이밍 동적)

언어 참고: 엔진 기반 /api/v1/horoscope/reports/* 엔드포인트는 현재 영어만 지원합니다 (lang=en). 보고서가 아닌 엔드포인트는 문서화된 경우 번역 보조 언어 옵션을 지원할 수 있습니다.

별자리 시스템 응답 명확성¶

zodiac_system: "tropical"를 선택하면 보고서 계산은 트로피컬 상태를 유지합니다. zodiac_system: "sidereal"를 선택하면 보고서 계산은 사이드럴 상태를 유지합니다.

요청 본문에 zodiac_system가 제공되지 않으면 엔진은 기본적으로 tropical로 설정됩니다.

선택한 모드를 고려하더라도 응답 메타데이터에서 트로피컬, 사이드럴 및 아야남사 관련 필드가 표시될 수 있습니다.이 필드는 비교, 투명성 및 관찰 목적으로만 반환됩니다. 이는 선택된 별자리 시스템의 실제 보고 계산을 변경하거나 수정하지 않습니다.

매일 앱 UI 통계 강조¶

주요 매일 개인화된 엔드포인트는 풍부하고 사용자 친화적인 통계를 data.daily_personalized_stats에서 제공합니다.

개인화된 매일 통계에는 다음이 포함됩니다.

overall_pulse
archetype_scores
harmony_discord
elemental_balance
momentum_channels
confidence (각 블록당)

daily_stats_detail: "full" | "compact"를 사용하여 모바일/웹 클라이언트에 대한 데이터 전송 밀도를 제어합니다.

아키텍처¶

전체 엔진 아키텍처¶

전체 별자리 엔진 아키텍처

요청-응답 아키텍처¶

별자리 요청-응답 아키텍처

런타임 분해¶

생산 환경의 별자리 스택은 결정론적 파이프라인을 따릅니다.1. API 게이트웨이는 인증, 할당량 및 요청 정책을 검증합니다. 2. FastAPI 앱은 계약을 검증하고 캐시를 확인합니다. 3. HoroscopeService는 서명, 기간 창, 천문 데이터 설정 및 모드를 해결합니다. 4. EphemerisEngine는 위치, 측지, 하우스, 상승 지점을 계산합니다. 5. AggregationEngine는 기간 이벤트, 지표 및 순위 기반 동인을 추출합니다. 6. InterpretationEngine는 요인 스택을 추적 가능성을 갖춘 편집 출력에 매핑합니다. 7. 응답이 조립되고 메타데이터로 감싸여 캐시됩니다.

이 아키텍처는 동일한 페이로드에 대해 반복 가능한 출력을 제공하는 동시에 유료 앱 경험에 대한 심층적인 개인화를 가능하게 합니다.

신뢰 모델: 폐쇄형 핵심 + 경량 오픈 소스¶

주요 엔진은 폐쇄형 소스이며 엔터프라이즈 수준의 결정론적 보고서, 프리미엄 편집 레이어 및 프로덕션 안정성을 위해 최적화되어 있습니다.

투명성과 개발자 신뢰를 촉진하기 위해 우리는 강력하고 가벼운 오픈 소스 엔진도 유지 관리합니다:

OpAstro 웹사이트: opastro.com
OpAstro 소스: github.com/dakidarts/opastro
OpAstro 패키지: pypi.org/project/opastroOpAstro를 사용하여 엔진 품질을 빠르게 평가하고, 풍부한 보고 레이어, 광범위한 엔드포인트 커버리지 및 관리된 프로덕션 운영을 위해 NumerologyAPI 엔터프라이즈 라우트로 확장합니다.

시작하기¶

빠른 시작: 개인화된 일별 + 앱 통계¶

[bash curl --request POST \ --url "https://api.numerologyapi.com/api/v1/horoscope/reports/today?lang=en" \ --header "X-API-Key: YOUR_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "dob": "1992-07-16", "timezone": "America/New_York", "birth_time": "13:45", "birth_latitude": 40.7128, "birth_longitude": -74.0060, "birth_timezone": "America/New_York", "daily_stats_detail": "compact" }'

이 API는 실시간 일별 보고서와 data.daily_personalized_stats를 반환하며, 이는 앱 카드 및 트렌드 모듈에 사용됩니다.| 목표 | 권장 엔드포인트 패밀리 | |---|---| | 일반적인 신호 기반의 일일 보고서 | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday | | 개인화된 일일 보고서 + 앱 통계 카드 | 주요 경로 [daily-today.md] 와 함께 birth_time, 좌표 및 daily_stats_detail 사용 | | 주기적인 일반 보고서 | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly | | 섹션별 보고서 (경력, 건강, 재정, 소통, 우정, 라이프스타일, 사랑) | 기간별 섹션 경로 [weekly.md] | | 행성 중심의 편집 보고서 | 행성 경로 [planetary-daily.md] | | 측면 중심의 편집 보고서 | 측면 경로 [aspects-daily.md] | | 이동 중심의 편집 보고서 | 이동 경로 [transits-daily.md] | | 하우스 중심의 개인화된 보고서 | 하우스 경로 [house-daily.md] | | 행성-하우스 개인화된 보고서 | 행성-하우스 경로 [planet-house-daily.md] | | 고도의 상세한 선천 차트 + 휠 아티팩트 | 출생 차트 경로 [birth-chart.md] |

엔드포인트 매핑¶

이 매핑을 사용하여 제품에 필요한 정확한 경로 패밀리로 직접 이동할 수 있습니다.

선천 차트 및 기초¶

전체 선천 차트 [birth-chart.md]
선천 차트 이미지 [birth-chart-image.md]
타임존 헬퍼 [../../timezone-helper.md]

일일 운세- 어제 운세 ¶

주간 운세- 주간 운세 ¶

월간 운세¶

연간 운세¶

사랑 운세¶

행성, 각도, 이동 및 주별 보고서- 행성별 일일 섹션 ¶

별자리 정보 설명 (실시간 보고서 아님)¶

이 /api/v1/horoscope/sign/* 엔드포인트는 설명적인 별자리 유형 의미를 반환하며, 실시간 천문학적 보고서는 아닙니다. 실시간 보고서 생성을 위해 /api/v1/horoscope/reports/*을 사용하십시오.- 성격 분석 - 소통 스타일 - 우정과 친화력 - 사랑과 유혹 - 생활 방식 및 미학 - 건강 및 활력 - 영성과 영적 사명 - 그림자 패턴 - 직업 - 돈 - 부모와 자녀

호환성 및 백과사전¶

가장 적합한 대상¶

천문학 모바일 및 웹 앱
개인화된 일일 보고서 피드 및 뉴스레터
호환성 및 관계 제품
웰니스, 코칭 및 영적 대시보드
결정론적인 반복이 필요한 엔터프라이즈 통합

NumerologyAPI.com에 의해 제공