コード不要の統合

このページのすべては2026-09-17の本番環境に対して実行されています。n8n用のワークフローはインポートされ、実際のn8nで起動されています；ZapierとMakeの手順はそれぞれのツールの公式ドキュメントに従って記述され、彼らが組み立てるリクエストはそのまま送信されます。

リクエストはどこから来るか

• Zapier, Make と n8n は自分のサーバーから送信します。以下に記載のとおり、エンドポイント領域と予算を持つ「サーバーのみ」キーが必要です。手順: Zapier, Make, n8n.
• Bubble も自分のサーバーからリクエストを送信し、キーはヘッダーにありそのまま残ります: Bubble.
• FlutterFlow はユーザーが保持するアプリにコンパイルされるため、呼び出しはプライベートにする必要があります: FlutterFlow.
• Wix, Squarespace, Shopify, Webflow と Tilda は訪問者のブラウザでページを表示します。キーではなくウィジェットを埋め込んでください: サイトビルダー.
• WordPress は自分のサーバーからアクセスします。キーは プラグイン AstroWay が管理します。

注意

パブリックキー pk_ は Zapier、Make、n8n では機能しません。リストにない origin がないリクエストは拒否され、これらのツールは origin を送信しません。サイトページからはリストにある origin のみで機能します。

自動化用キー

Zap、スクリプト、またはワークフローを編集できるすべての人がキーを内部で見ることができます。したがって、各自動化に固有のキーを付与し、その動作に合わせて制限してください。

1. ダッシュボードで APIキー を開き、新しいキー をクリックします。自動化に合わせて名前を付けます（例: zapier-intake-form）。
2. フィールド このキーはどこで使用されますか？ で サーバーのみ を選択したままにします。
3. キーをコピーして保存します：ダイアログはキーを一度だけ全体表示します。キーを紛失した場合は、キーのメニューで キーを更新 をクリックしてください。新しいキーが発行され、古いキーは無効になります。
4. キーのメニューで エンドポイント領域 を開き、自動化が呼び出すパスを1行ずつ列挙します：chart は出生図、public/horoscope/* は日次ホロスコープ用です。
5. 同じメニューで 予算を設定 を開き、このキーがサイクルごとに使用できるクレジット数を指定します。

リスト外の呼び出しは 403 ENDPOINT_NOT_IN_SCOPE を返します。予算を使い切ったキーは 429 KEY_BUDGET_EXHAUSTED を返し、アカウントにクレジットが残っていても、ループした自動化は指定された回数で停止します。これらの制限はすべてのプランで有効で、認証 セクションに記載されています。

誕生時刻を送信し、オフセットは送らないでください

フォームは日付、時計の時刻、場所を提供します。以下のように送信してください：

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}

• timezone はゾーン名で、サーバーはその日の時計が持っていたUTCオフセット（夏時間を含む）を自動的に取得します。キエフは1990-05-15はUTC+4で、+3ではありません：手動で入力したオフセットはこのようなエラーを引き起こします。auto を送信して座標からゾーンを取得してください。
• timezone とオフセットを省略 すると、マップはUTCで計算されます。レスポンスは常に 200 になるので、フィールドが正しくマッピングされているか確認してください。
• 空の timezone は 400 で拒否されます。そうしないと、未入力のフォームフィールドがUTCとして扱われてしまうためです。
• date は YYYY-MM-DD 形式、time は HH:MM:SS 形式です。フォームが別の形式で保存している場合は、ツール内で日付をフォーマットしてください。
• 数値は文字列として送信されることがあります。 \"latitude\": \"50.45\" は受け入れられ、ほとんどのフォームフィールドがこのように送信します。
• API はジオコーディングしません。 座標はフォームまたはツール内のジオコーディングステップから提供される必要があります。city フィールドは単なるラベルです。

1970年以前の時計と日付の変換ルールは フィールド形式 に記載されています。

経度をサインに変換する方法

POST /v1/chart は黄道帯に沿った度数で返し、ラッパーは { "ok": true, "data": { ... } } です。サインは floor(longitude / 30) で、0から数えます:

0 牡羊座, 1 牡牛座, 2 双子座, 3 蟹座, 4 獅子座, 5 乙女座, 6 天秤座, 7 蠍座, 8 射手座, 9 山羊座, 10 水瓶座, 11 魚座.

最も一般的な3つの値は次の場所にあります：

• Sun: data.planets のエントリで "name": "Sun"、最初のもの。
• Moon: data.planets のエントリで "name": "Moon"、2番目のもの。
• Ascendant: data.houses.ascendant。
• 使用されたオフセット: data.input.timezoneOffset。

上記の例では: Sun 54.34 → 牡牛座; Moon 296.39 → 山羊座; Ascendant 159.26 → 乙女座; オフセット 4。

コストはどれくらいですか

• POST /v1/chart は20クレジットかかります。完全な表は エンドポイント料金 ページにあります。
• 同じリクエストを5分以内に再送すると、キャッシュから返され、クレジットは消費されません。同一のペイロードを繰り返すテスト実行は予算を消費しません。
• GET /v1/public/horoscope/daily はクレジットを消費しません。キーなし、またはFreeプランのキーの場合、IPアドレスごとに1時間あたり30リクエストの制限があります。自動化プラットフォームはアドレスをクライアント間で分割します。有料プランのキーは独自のリミットを持ちます。