Muhurta API - 有利な日を選択する (ヴェダ的選択的占星術)

Muhurta - ヴェーダの選挙占星術です：重要なイベントのための吉時を選びます。API は、あなたの検索ウィンドウ内の各日をスキャンし、日の出時のパンチャンガ (Tithi · Vara · Nakshatra · Yoga · Karana) に基づいて特定の活動に対して評価し、説明付きのトップ N の良い日を返します。

どうやって動くか

1. 活動を選択してください（12種類のうち1つ: /muhurta/types でリスト取得）、検索ウィンドウ（最大90日）、および場所（日の出は座標に紐付け）
2. API は各日の日の出時のパンチャンガを計算し、活動の古典的ルール（Muhurta Chintamani + B.V. Raman）に基づいてスコアリングします。
3. レスポンス: スコアでソートされたトップ N の日、パンチャンガ、サブウィンドウ Abhijit Muhurat、およびスコアリング要因（why）

エンドポイント

エンドポイント	メソッド	クレジット	目的
/v1/muhurta/types	GET	0	12 のアクティビティのカタログ（キー + サンスクリット + 説明）
/v1/vedic/muhurat/{activity}	POST	Tier 3	1 つのアクティビティに対するウィンドウをスキャン → トップ N の日 (JSON)
/v1/reports/muhurta	POST	Tier 7	吉日のレポート - PDF (デフォルト) または HTML (?format=html)

12 のアクティビティ

marriage (Vivah) · vehicle-purchase (Vahana) · business-start (Vyapara) · travel (Yatra) · naming-ceremony (Namkaran) · surgery (Shastrakarma) · education-start (Vidyarambha) · investment (Dhana Sthapana) · property-purchase (Griha Pravesh) · journey-long · name-change · general-auspicious.

レポート

POST /v1/reports/muhurta は 標準の A4 レポート を /v1/reports/* と同じ方法で返します：同期レンダリングがレスポンスに行われ、デフォルトは PDF、?format=html はレンダリングなしで HTML を返します。 トップ推奨、日のランク付けリスト、各日のパンチャンガ、Abhijit Muhurat、およびスコアリング要因を根拠として含みます。 アカウントに紐付けられたキーに対して、白ラベル (ロゴ/カラー/フォント) をサポートします。

例

curl -X POST https://api.astroway.info/v1/reports/muhurta \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "activity": "marriage", "search_window_start": "2026-07-01",
        "search_window_end": "2026-07-31", "latitude": 28.61,
        "longitude": 77.21, "timezoneOffset": 5.5, "topN": 5 }'
# → { "url": "https://api.astroway.info/reports/…-muhurta.pdf", "page_count": 3, "expires_at": "…" }
# (?format=html повертає HTML напряму)

ノート

Muhurta は古典的テキストに基づく補助モデルであり、指示ではありません。surgery および医療イベントについては、現代の計画が優先されます。