APIの数秘術: 1つのルートで5つの計算システム

数秘術は、APIが通常完全にスキップするか、単一のピタゴラス式「life path number」に限定する、エソテリックスタックの一部です。私たちは異なるアプローチを取りました。5つの完全なシステム、それぞれに10の標準的な計算があり、1つのパラメータ化されたルートで提供します。

合計で、/numerology/{system}/{calc}の下に50のエンドポイントがあり、さらに独立した運命の行列（Destiny Matrix）があります。以下に、その仕組みと、なぜ1つのルートで十分なのかを説明します。

すべての計算は以下のテンプレートの下にあります。

POST /v1/numerology/{system}/{calc}

{system}は5つの値のいずれかです。各システムには独自の「文字 → 数字」対応表と独自の還元ルールがあるため、同じ名前でも流派によって結果が異なります。

未知のシステムは、許容される値のリストとともに400 INVALID_SYSTEMを返します。ピタゴラス式へのサイレントなフォールバックはありません。

同じ10種類の計算が、5つのどのシステムでも利用可能です。

• 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を受け取ります。

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が2ではなく11になったのかを推測する必要はありません。チェーンが明示的に提供されます。

運命の行列（Destiny Matrix）は古典的な数秘術の一部ではないため、独自のルートにあります。

POST /v1/destiny-matrix

これは、生年月日からオクタグラムに展開される22枚のタロット大アルカナに基づくメソッドです。中央の十字、祖先のライン、お金と人間関係のゾーンの位置を返します。これは行列をレンダリングするための準備された構造です。これは別のモデル（数字の還元ではなくアルカナ）であるため、/numerology/*の外に置いています。

数秘術の計算は、エフェメリスなしの文字列と日付に対する純粋な算術です。そのため、これらは決定論的で安価です。同じ入力は常に同じ出力を生成し、キャッシュは簡単です。解釈（meaning）は静的なテーブルであり、LLMではないため、幻覚や呼び出し間の変動はありません。

数字の上に自由形式のテキストが必要な場合は、それはAIを備えた別のレイヤー/interpret/*になりますが、基本的な数字は常に決定論的なコアから提供されます。

数秘術は、タロット、ルーン、ジオマンシー、易経とともに、エソテリックアドオンパッケージに含まれています。各呼び出しには固定のクレジットコストがかかります（計算エンドポイントであり、AIエンドポイントではないため安価です）。無料プランでは月額10,000クレジットが提供され、これにより数百人のユーザーの完全な数秘術プロファイルを1ヶ月間無料で収集するのに十分です。

1. dashboard/sign-upでキーを取得する
2. あなたのオーディエンスに合ったシステムを選択してください（ピタゴラス式は西洋市場のデフォルト、ヴェーダ式はインド市場向けです）
3. 10回の呼び出しでプロファイルを収集するか、特定の画面に合わせて1つの数字をフェッチしてください

フィールドとスキーマの完全なリストは、OpenAPIドキュメントのNumerologyグループにあります。