サイト向けの占星ウィジェット

公開HTMLウィジェット GET /v1/embed/* は、完成済みのiframeフラグメント（SVGホイール、ホロスコープ、数秘術など）を返す。APIキー不要、訪問者のIPごとのレート制限（1時間あたり120リクエスト、/v1/public/* とは別枠なので、複数のウィジェットを載せたページでも制限に引っかからない）、キャッシュは public, max-age=300。マーケティングページに最適。高トラフィックの本番環境では SDK を使おう。

<iframe src="https://api.astroway.info/v1/embed/wheel?date=1990-05-15&time=14:30&lat=50.45&lng=30.52&tz=2&theme=dark"
        width="460" height="560" style="border:0"></iframe>

はじめに

埋め込み方法はサイトの作り方によって変わる。コンテンツは同じで、違うのは自分でやる作業の量だけだ。

サイト	使うもの
WordPress	AstroWay プラグイン：18個のショートコードと26個のGutenbergブロック。11個のウィジェットはインストール直後からキーなしで動く。
WordPress + Elementor	AstroWay for Elementor：7個のウィジェットをエディター上でドラッグ＆ドロップするだけ。
Tilda、Squarespace、Wix、通常のHTML	下記のスクリプトローダー、またはギャラリーから完成済みの `<iframe>` を取得。ワンクリックでコピーできる。
独自フロントエンド	同じ `/v1/embed/*` エンドポイント。レイアウトを完全に制御したいなら SDK。

プラグインはこのページのエンドポイントと同じコンテンツを返すが、テーマのデザインに合わせて描画し、高さの手動調整も不要だ。

独立したウィジェット：ネイタルチャート計算機

このページのウィジェットは、あなたがすでに知っている情報（日付・時刻・場所は自分で渡す）を描画する。訪問者自身にデータを入力させたい場合は、別のウィジェットネイタルチャート計算機（パッケージ @astroway/widget）がある。フォーム・計算・ホイールが1つの埋め込みで完結し、10言語、ライト／ダークテーマ対応だ。

違いはデザインではなく、計算がどこで行われるかだ。計算機は訪問者のブラウザ内で計算するため、出生データはサーバーに一切送信されない。/v1/embed/* ウィジェットはこちら側で計算するので、パラメータはiframeのURLに見える。

必要なもの	選ぶもの
訪問者が自分の出生データを入力する	計算機 `@astroway/widget`
出生データをブラウザの外に出さない	計算機 `@astroway/widget`
ホロスコープ、トランジット、タロット、数秘術、パンチャンガなど残り12タイプ	このページのウィジェット
10言語ではなく20言語	このページのウィジェット

スクリプトローダー

iframeの高さを自分で計算したくないなら、ローダーを読み込もう。ローダーは自分自身の位置にiframeを挿入し、ウィジェットが postMessage でサイズを通知するため、コンテンツに合わせて高さを自動調整する。

<script src="https://cdn.astroway.info/embed.js"
        data-widget="wheel" data-date="1990-05-15" data-time="14:30"
        data-lat="50.45" data-lng="30.52" data-tz="3"></script>

任意の data-* 属性はクエリパラメータになるので、data-theme="light" や data-lang="en" はiframeの例と同じように動く。data-height="500" は高さを固定して自動調整を無効にする。1ページに複数のウィジェットを置いても互いに干渉しない。

キーは不要で、受け付けもされない。 /v1/embed/* エンドポイントは公開されており、属性にキーを書くとページのソースコードに残ってしまう。ローダーはそのような属性を無視し、コンソールに警告を出す。

どのURLを読み込むか

ファイル	キャッシュ	向いている人
`https://cdn.astroway.info/embed.js`	5分	標準的な選択。修正が自動的に反映される。
`https://cdn.astroway.info/embed.v1.js`	1年、immutable	不変性が必要な場合。セキュリティ目的でのみ更新され、動作変更は `embed.v2.js` に入る。

ウィジェットギャラリー

全16ウィジェットのライブプレビュー。テーマとコンテンツ言語を選び、スニペットを <iframe> と <script> ローダーで切り替えて、完成したコードをコピーできる。

共通パラメータ

すべてのウィジェットで受け付ける：

パラメータ	値	デフォルト	説明
`theme`	`dark` · `light` · `console`	`dark`	カラースキーム。
`lang`	`uk` · `en` · 他18言語	`uk`	コンテンツの言語。`Accept-Language` ヘッダーからも読み取られる。
`disclaimer`	`1` · `true` · `yes`	無効	フッターに、コンテンツが娯楽・参考目的である旨の免責文を追加する（医療・心理・金融・法律上の助言ではない）。

ウィジェット一覧

ウィジェット	Endpoint	固有パラメータ
今日のホロスコープ	`GET /embed/daily-horoscope`	`sign`, `date`
ネイタルホイール	`GET /embed/wheel` （エイリアス `/embed/natal`）	`date`, `time`, `lat`, `lng`, `tz`, `city`
トランジットタイムライン	`GET /embed/transit-timeline`	`date`, `days`（最大30）
ボディグラフ（Human Design）	`GET /embed/bodygraph`	`date`, `time`, `lat`, `lng`, `tz`
ヴェーダ式クンダリ	`GET /embed/kundli`	`date`, `time`, `lat`, `lng`, `tz`
ミニチャート	`GET /embed/mini-chart`	`date`, `time`, `lat`, `lng`, `tz`, `city`
今日の惑星	`GET /embed/planet-of-day`	`date`
月相	`GET /embed/moon-phase`	`date`
今日のタロット	`GET /embed/daily-tarot`	`date`
月間予報	`GET /embed/monthly-forecast`	`sign`, `month`（`YYYY-MM`）
天空のトランジット	`GET /embed/transit`	`date`
数秘術	`GET /embed/numerology`	`name`, `date`, `system`（`pythagorean` · `chaldean`）
パンチャンガ	`GET /embed/panchang`	`date`, `lat`, `lng`, `tz` （座標は必須）
シナストリー	`GET /embed/synastry`	`date_a`, `time_a`, `lat_a`, `lng_a`, `tz_a`, `date_b`, `time_b`, `lat_b`, `lng_b`, `tz_b`
ムーンカレンダー	`GET /embed/moon-calendar`	`month`（`YYYY-MM`）, `tz`
タロットスプレッド	`GET /embed/tarot-spread`	`spread`（`single-card` · `three-card` · `decision` · `career`）, `date`, `seed`, `reversed`, `art`

フォーマット：日付は YYYY-MM-DD、時刻は HH:MM、tz はUTCからの時差（時間単位）。未指定のパラメータには賢いデフォルト値（現在の日付、正午、赤道）が使われる。

参考になりましたか？

編集を提案

最終更新日: 2026/10/09