コンテンツにスキップ

Numerology API + Horoscope API v1.0.0 一元化変更履歴

完全なホロスコープエンジンアーキテクチャ

リリース日: 2026-04-12
バージョン: v1.0.0
範囲: The Numerology API、Horoscope Expansion を含む、完全なプラットフォームリリース：包括的なエンドポイント展開、エンジンベースのホロスコープレポート移行、リクエスト/レスポンスの正規化、ドキュメントの一貫性、多言語検証、および本番環境への統合に関するガイダンス。

概要

v1.0.0 は、Dakidarts API プラットフォーム全体での主要な本番リリースです。これは、2 つの大規模な開発トラックを 1 つの調整された展開に統合します：

  1. Numerology API の拡張
  2. 完全な拡張された numerology インターフェースを追加します。
  3. 個人週間と宇宙の日/週/月/年のタイミング/サイクル範囲を拡大します。
  4. より深い精神的、関係性、アイデンティティ、影分析のエンドポイントを導入します。
  5. ドキュメントの一貫性、レスポンス例、および多言語の動作検証を完了します。2. ホロスコープ拡張
  6. ホロスコープレポート生成を社内製 Swiss Ephemeris エンジンへの主要な移行作業を完了します。
  7. /api/v1/horoscope/reports/* の下で、エンジンによるレポートルートを標準化します。
  8. 日次、週次、月次、および年次期間全体での幅広いセクションのカバーを提供します。
  9. 周期的な惑星、アスペクト、トランジット、およびハウスレポートスイートを導入します。
  10. パイロードの一貫性、パーソナライゼーション動作、互換性エイリアス、およびドキュメントの一致を強化します。

この変更ログは、統合者、内部展開レビュー、サポート、移行計画、および顧客向けリリースコミュニケーションのための唯一の情報源として使用することを目的としています。

プラットフォーム全体でのハイライト

v1.0.0 がプラットフォーム全体で提供するもの- 主要な v1.0.0 プロダクションリリース が、Numerology API および Horoscope API の両方で実施されました。

  • Numerology と Horoscope 製品におけるエンドポイントの範囲が大幅に拡大しました。
  • 主要なレポートフローに対する エンジンによるホロスコープ計算の移行 が完了しました。
  • Extended Numerology リリーストラックの完了。
  • アップグレードされたホロスコープルート向けの、POST を優先した構造化リクエストパターン の改善。
  • 豊富なレスポンスペイロード、エンタープライズ用ラップ、およびメタデータの一貫性に対するサポートが強化されました。
  • 公開ドキュメントとサンプルペイロード全体での ドキュメンテーションの一致 が実現しました。
  • Numerology の拡張エンドポイントに対する 多言語による初期検証 が成功しました。
  • 運用上の明確性が向上し、プロダクションクライアント向けの ルートの明瞭性、互換性の処理、および移行ガイダンス が提供されました。
  • 出生ベクトルや高度なリクエストフィールドが提供される場合に、パーソナライズされた計算 のサポートが拡張されました。
  • ホロスコープリクエストフローにおけるタイムゾーン、占星術システム、アヤンサマ、ハウスシステム、およびノードの動作に関する運用上の明確性が向上しました。

リリース内容の概要### 数占 API の拡張

  • 新しいエンドポイントファミリーが追加: 23
  • 組み合わせられた操作が追加 (GET/POST): 41
  • 検証/テストリクエストを実行: 205
  • 多言語でのテスト成功を文書化: 100.0%
  • 拡張されたリリースモデル: 付加的, 新しい拡張版スイートでは正式な非推奨がありません

星占 API の拡張

  • 主要なレポートが社内エンジンに移行
  • 追加された新しいレポートスイート:
  • 行星
  • 影響
  • トランスিট
  • ハウス
  • 行星とハウス
  • /api/v1/horoscope/reports/*の下で、標準的なレポート名前空間が確立
  • 公開ドキュメントが標準的なパスに移行する際に、複数のレガシールートを隠れた互換性のアliasとして保持

第1部 — 数占 API v1.0.0

数占 API の拡張ハイライト- 「Extended Numerology」の完全な表面を、拡張ドキュメントセクションの下で文書化しました。

  • Personal Week を追加し、完全な GET/POST の互換性と豊富なレスポンスペイロードのサポートを実現しました。
  • 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) 精神的および影分析 エンドポイント

``| エンドポイント | メソッド | パス | |---|---|---| | Aura Frequency Reading |GET,POST|/api/v1/aura-frequency-reading| | Chakra Numerology |GET,POST|/api/v1/chakra-numerology| | Past Life Patterns |GET,POST|/api/v1/past-life-patterns| | Shadow Work Number |GET,POST|/api/v1/shadow-work-number| | Soul Contract Reading |GET,POST|/api/v1/soul-contract-reading| | Soul Connection Indicator |POST|/api/v1/soul-connection-indicator| | Spiritual Gifts Reading |GET,POST|/api/v1/spiritual-gifts-reading| | Sacred Balance Reading |GET,POST|/api/v1/sacred-balance-reading` |

D) Relationship Dynamics エンドポイント

エンドポイント メソッド パス
Relationship Composite POST /api/v1/relationship-composite
Relationship Healing Reading POST /api/v1/relationship-healing-reading
Parent Child Numerology 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を発生させた5つの操作は、本番環境に近いテスト入力のカバー範囲のために安定化され、多言語のスモークテスト下で成功応答を返すようになりました：

  • 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[]に少なくとも2つのエントリが必要です。
  • カレンダーとヒートマップの月入力は、YYYY-MM形式を使用します。
  • 警告の日付top_nは、範囲1..31に制限されています。
  • クライアントのペイロードは、送信前に事前検証を行うことで、不要な422や形式レベルのエラーを削減できます。

D) ドキュメントとOpenAPIの一貫性修正

すべての拡張ドキュメントを統合の一貫性に合わせて標準化しました：

  • 各メソッドごとの完全なパラメータテーブル
  • パラメータオプションの詳細
  • パターン、範囲、デフォルト値、およびネストされたオブジェクトフィールド
  • スモーク生成されたペイロードに基づく豊富なレスポンス例セクション
  • 標準化されたアクセスと可用性のメモ
  • ダッシュボードのCTA、メモセクション、および関連エンドポイントのフッター## Numerology API — 品質保証の概要

拡張された 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 と POST の使用に関するガイダンス

ほとんどの拡張されたエンドポイントは、GET と POST を両方サポートし、同等の出力形式を使用します。

使用方法：

  • GET は、単純なクエリベースの呼び出しに使用
  • POST は、より構造化されたペイロード、ネストされたオブジェクト、および SDK/バックエンドの一貫性に使用

このリリースに含まれる POST のみで動作するエンドポイントは以下のとおりです：

  • /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 表面、高度な関係および精神分析、より豊かなリクエスト/レスポンス契約、および完全に同期されたドキュメントとスモークテストとの整合性を導入します。# 第 II 部 — ホロスコープ拡張 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) アスペクトレポートスイート (期間ごとの表面)

セクション（一般向け以外）：

  • 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) レポートネームスペースの正規化

アップグレードされたエンジンによるホロスコープ表面全体で、ライブレポートパスは/api/v1/horoscope/reports/* ネームスペースを使用します。

レガシー非レポートパスは、互換性のあるエイリアスとして登録されています。

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 という名前の、情報的な用語集スタイルの動作を置き換えます。--- REVISED TRANSLATION ---

ホロスコープ拡張 — 更新および修正されたエンドポイント

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

既存のカテゴリのエンドポイント（旧 horoscope.com の動作から）

  • キャリア
  • 健康
  • 愛
  • お金

既存および旧のファミリーを再構成し、アップグレード

  • 旧の愛に関するエンドポイントが love_singles と love_couples に分割
  • yearly/career_money の動作を専用の年次キャリアおよび年次のお金のエンドポイントに置き換え
  • 行星に関する旧のレポートおよび概要のエンドポイントを期間化されたエンドポイントに移動

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

改善点：

  • fuller gateway-to-engine のリクエストオプションのサポート

---- ホイール構成フィールドの一貫性

---- より厳格なレスポンス形状のガード

E) レスポンス契約の正規化

改良されたホロスコープエンジンによるエンドポイントの返却内容： - Raw エンジンからのレスポンスペイロード

--- END MARKDOWN ---- _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} | "Daily love" が現在、関係のコンテキストで分割されています。 || 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

ホロスコープ拡張 - ドキュメントとQAの一貫性完了

  • 公開ドキュメントを、ホロスコープルートのアップグレードに合わせて更新

---- 過去の惑星に関するドキュメントを、特定の期間に合わせた惑星に関するドキュメントに置き換えました。- キャリアと金銭に関するドキュメントを、統合されていたルートから分割

---- エンドポイントの応答と同期された、スモークバックドの例を示すJSON

ホロスコープ拡張 - 推奨されるクライアントアップグレードチェックリスト

  • すべてのリネームおよび非推奨のパスを、マイグレーションマップを使用して更新する

---- レガシーな GET クライアントがアップグレードされたレポートルートを使用している場合、POST リクエストの本文に切り替える

---- すべてのデイリーフローにタイムゾーンを追加し、相対日付のずれを防ぐ

---- ユーザー固有の編集が必要な場合に、パーソナライズされたフィールドを追加する

---- 応答解析器を更新して、_enterprise と _api_metadata_ を保持する

---- 運用環境で使用されているすべてのホロスコープエンドポイントに対する統合テストを再実行する

ホロスコープ拡張 — リリースノート概要

Numerology API v1.0.0 は、主要なエンジンとの整合性を実現し、レポートの範囲と期間を拡大し、より明確な標準的なルート構造を導入し、社内ホロスコープエンジンの今後のバージョン向けに明確なプロダクション環境を確立します。

第3部 — クライアント向けのAPI連携ガイダンス

Numerology APIを使用するクライアントのための統合ノート

NumerologyエンドポイントとHoroscopeエンドポイントの両方を消費するクライアントは、以下の内容を合わせて確認する必要があります。

認証とアクセス

  • Numerologyの拡張されたエンドポイントは、RapidAPIゲートウェイでのサポートなしで、プラットフォームのみで使用 (direct-platform only)
  • エンジンによるホロスコープルートも同様に、標準的なAPI名前空間内で動作し、ゲートウェイパターンが向上しています。
  • 企業向けのメタデータラッパーのサポートを維持

リクエストモデリング

  • 新しく拡張または変更されたすべてのルートに対して、明示的な構造化されたPOSTボディを使用することを推奨します。
  • 日付形式、期間セレクター、タイムゾーン文字列、およびネストされたオブジェクトをクライアント側で検証
  • 利用可能な場合は、より豊かな出力のためにパーソナライゼーションベクトルを提供### 時区と日付の扱いに関する注意点
  • Numerology エンドポイントは、正しい日付と月の形式に依存します。
  • Horoscope の日次ルートは、相対的な日の解決のために、正しいタイムゾーンの処理を必要とします。
  • IANA タイムゾーン文字列を使用することを強く推奨します（サポートされている場合）。

言語の扱いに関する注意点

  • Numerology の拡張エンドポイントは、徹底的にテストされた多言語でのレンダリングを実現しています。
  • Engine によってバックされる Horoscope ルートは、en のみ引き続きサポートします。

本番環境へのリリースに関するアドバイス

  • まず SDK とリクエストバリデーターを更新してください。
  • 次に統合テストを再実行してください。
  • その後、ルート/パスの変更を本番環境のクライアントにプロモートしてください。
  • 内部でまだ使用されている隠れた互換性エイリアスを監視し、将来的に自信を持って削除できるようにします。

第4部 — 最終リリース概要

v1.0.0 の意味

v1.0.0 は、両方のインターフェースが大幅に完成し、本番環境に適した状態になった時点です：- Numerology API は、タイミング、アイデンティティ、精神的な洞察、影の仕事、人間関係、相性、および予測カレンダーを含む、より豊富な拡張カタログを公開します。 - 占星術レポート は、標準化されたレポート命名空間、広範なセクションのカバー範囲、明確な移行パターン、およびレポートファミリー間の優れた整合性を備えた、より強力なエンジンベースの基盤上に構築されています。 - ドキュメント、例、検証動作、および互換性に関するガイダンスは、v1.0.0 以前の状態よりも大幅に成熟しています。

このリリースは単なるバージョンアップではありません。プラットフォームの完全性、ルートの明確さ、クライアントの移行準備、ドキュメントの信頼性、エンタープライズ統合の一貫性を向上させる構造的なリリースです。

運用上の推奨事項

すべてのアクティブな統合者向けには、以下の手順をお勧めします。

  1. 標準化されたルートを直ちに採用する
  2. POST で送信されるペイロードの場合に、リクエストモデルを更新する
  3. メタデータラッパーの解析を維持する
  4. タイムゾーン/日付形式をクライアント側で検証する
  5. Numerology の拡張消費者による直接プラットフォームへのアクセスを移行する
  6. 本番環境への展開前に、完全な統合の煙テストを実行する

締めくくりこの統合されたリリースノートは、The Numerology API の v1.0.0 リリース状態を反映し、2026-04-12 のリリースウィンドウにおける主要な機能に関する変更点をまとめたものです。