ホロスコープレポート API の概要¶

Swiss Ephemeris を搭載した、本番環境向けに設計された決定論的なエンジン上で、占星術製品を構築します。

この API は、以下の 2 つの高価値なレポートモードをサポートします。

Public mode - 大規模での安定したサインベースの出力
Personalized mode - 出生データに基づいた詳細なベクトル (ハウス、アスペクト、タイミングダイナミクス) を持つ編集レポート

言語に関する注記: エンジンを搭載した /api/v1/horoscope/reports/* エンドポイントは現在、英語のみをサポートしています (lang=en)。レポート以外のエンドポイントでは、ドキュメントされている場合は翻訳支援言語オプションが利用可能です。

天座システム応答の明確化¶

zodiac_system: "tropical" を選択した場合、レポートの計算はトロピカルなものに留まります。 zodiac_system: "sidereal" を選択した場合、レポートの計算はサイドリアルなものに留まります。

リクエストボディに zodiac_system が提供されない場合、エンジンはデフォルトで tropical にフォールバックします。

選択したモードに関係なく、応答メタデータにはトロピカル、サイドリアル、およびアヤンサマに関連するフィールドが表示される場合があります。これらのフィールドは、比較、透明性、および可観測性を目的としてのみ返されます。これらは選択された占星術システムに対する実際のレポート計算を上書きまたは変更しません。

毎日のアプリUI統計のハイライト¶

主要な毎日のパーソナライズされたエンドポイントは、data.daily_personalized_statsで豊富な、UIに優しい統計を提供します。

パーソナライズされた毎日の統計には、以下のものがあります。

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のエキスパートルートにスケールします。

ここから始める¶

迅速な開始: パーソナライズされた日次レポート + アプリ統計¶

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"
}'

このルートは、ライブの毎日レポートと、アプリカードおよびトレンドモジュール用のdata.daily_personalized_stats を返します。

ルート選択ガイド| 目標 | 推奨されるエンドポイントファミリー |¶

|---|---| | サインに基づく日次レポート | /horoscope/reports/today, /horoscope/reports/tomorrow, /horoscope/reports/yesterday | | パーソナライズされた日次レポート + アプリ統計情報 | 主要な日次ルートに、birth_time、座標、および daily_stats_detail を使用 | | 定期的な一般レポート | /horoscope/reports/weekly, /horoscope/reports/monthly, /horoscope/reports/yearly | | セクション別レポート (キャリア、健康、お金、コミュニケーション、友情、ライフスタイル、恋愛) | 期間横断的なセクションルート | | 惑星に焦点を当てた編集レポート | 惑星ルート | | アスペクトに焦点を当てた編集レポート | アスペクトルート | | トランスিটに焦点を当てた編集レポート | トランスিটルート | | ハウスに焦点を当てたパーソナライズされたレポート | ハウスルート | | 惑星とハウスのパーソナライズされたレポート | 惑星とハウスルート | | 詳細な誕生図 + ホイールアーク | バースチャートルート |

エンドポイントマップ¶

このマップを使用して、製品に必要な正確なエンドポイントファミリーに直接移動します。

誕生図と基礎¶

毎日のホロスコープ- 昨日占い ¶

週間占い- 週間総合占 ¶

月間占¶

年間占¶

恋愛占¶

惑星、アスペクト、トランジット、およびハウスレポート- 惑星のデイリーセクション ¶

星座記号の説明 (ライブレポートではない)¶

これらの /api/v1/horoscope/sign/* エンドポイントは、記述的な星座のアーキタイプの意味を返し、ライブな占星術レポートではありません。ライブレポートの生成には、/api/v1/horoscope/reports/* を使用してください。- パーソナリティ分析 - コミュニケーションスタイル - 友情と親和性 - 恋愛と誘惑 - ライフスタイルと美学 - 健康と活力 - 精神性と魂の使命 - 影のパターン - キャリア - お金 - 親子関係

互換性と用語集¶

活用例¶

占星術モバイルおよびウェブアプリケーション
パーソナライズされたデイリーレポートフィードとニュースレター
互換性および関係製品
ウェルネス、コーチング、スピリチュアルダッシュボード
エンタープライズ統合に必要な決定的な再現性

NumerologyAPI.com によって提供

ホロスコープ レポート API の概要¶