コンテンツにスキップ
AstroWay/api v2.356.2 · ja
すべてのシステムが正常です

コード不要の統合

Last updated Markdownとして開く エージェント設定

これらのページに記載されているすべての内容は、2026-09-17のプロダクション環境で実行されました。n8nのワークフローは実際のn8nにインポートされ、実行されています。ZapierとMakeの手順は、それぞれのツールのドキュメントに基づいて作成されており、それらが生成するリクエストはそのまま送信されています。Lovable、Bolt、Supabase、Dify、Telegram、WhatsApp、Slackのページは2026-11-07に検証され、それぞれに何が実行され、何が実行されなかったかの注記が付いています。

これによって、必要なキーの種類が決まります。

  • Zapier、Make、n8nは、それぞれのサーバーからリクエストを送信します。以下に説明するように、エンドポイントスコープと予算を持つ「サーバーのみ」キーが必要です。手順:Zapier、Make、n8n。
  • Bubbleもサーバーからリクエストを送信し、キーはそこに残るヘッダーにあります:Bubble。
  • FlutterFlowはユーザーが保持するアプリケーションにコンパイルされるため、呼び出しはプライベートにする必要があります:FlutterFlow。
  • LovableとBoltはブラウザに提供されるフロントエンドを構築するため、キーはSupabaseのサーバー関数内に存在します:Lovable、Bolt、関数自体はSupabase Edge Functionセクションにあります。
  • Difyは、当社のホスト型MCPまたはHTTPツールを介して、独自のサーバーからアクセスします:Dify。
  • Telegram、WhatsApp、Slackのボットはあなたのサーバー上で動作し、キーは環境変数にあります:Telegram、WhatsApp、Slack。
  • Wix、Squarespace、Shopify、Webflow、Tildaは訪問者のブラウザにページを表示します。キーではなくウィジェットを埋め込んでください:ウェブサイトビルダー。
  • WordPressはあなた自身のサーバーからアクセスします。AstroWayプラグインがキーを管理します。

Zap、スクリプト、またはワークフローを編集できる人は誰でも、内部にキーを見ることができます。そのため、各自動化に独自のキーを与え、そのキーが実行する内容に制限を設けてください。

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

リストにない呼び出しは 403 ENDPOINT_NOT_IN_SCOPE を受け取ります。予算を使い果たしたキーは 429 KEY_BUDGET_EXHAUSTED を受け取ります。アカウントにまだクレジットがある場合でも、ループに陥った自動化は指定された数で停止します。これらの制限はどちらもすべてのプランで機能し、認証セクションで説明されています。

オフセットではなく出生時刻を送信する

Section titled “オフセットではなく出生時刻を送信する”

フォームは日付、時計の時刻、場所を提供します。これらを次のように送信してください:

{
"date": "1990-05-15",
"time": "14:30:00",
"timezone": "Europe/Kyiv",
"latitude": 50.45,
"longitude": 30.52
}
  • timezone はゾーン名であり、サーバーは夏時間を含め、その日付の時計が保持していたUTCからのオフセットを自動的に見つけます。1990年5月15日のキエフはUTC+3ではなくUTC+4で生活していました。これは手動で入力されたオフセットが引き起こすエラーです。座標からゾーンを取得するには auto を送信してください。
  • timezoneもオフセットもなしの場合、チャートはUTCで計算されます。応答は 200 のままなので、フィールドがマッピングされていることを確認してください。
  • 空の timezone は 400 で拒否されます。そうしないと、未入力のフォームフィールドがUTCとして解釈されてしまうためです。
  • date は YYYY-MM-DD 形式、time は HH:MM:SS 形式です。フォームがこれらを異なる形式で保存する場合は、ツール自体の日付フォーマット機能を使用してください。
  • 数値はテキストとして送信される場合があります。 "latitude": "50.45" は受け入れられます。ほとんどのフォームフィールドはこのような形式で送信します。
  • チャートの呼び出しはジオコーディングを行いません。 座標はフォームから取得するか、その前に GET /v1/geo/search?q=... ステップを追加し、最初の結果から latitude、longitude、timezone を取得してください(場所の検索;キーのスコープに geo/search を追加してください)。city フィールドは単なるラベルです。

1970年以前の時計と日付の変換ルールは、フィールド形式で説明されています。

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

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

最も人気のある3つの値がどこにあるか:

  • 太陽: "name": "Sun" を持つ data.planets 内のエントリ、最初のもの。
  • 月: "name": "Moon" を持つ data.planets 内のエントリ、2番目のもの。
  • アセンダント: data.houses.ascendant。
  • 使用されたオフセット: data.input.timezoneOffset。

上記の例では:太陽 54.34、したがって牡牛座;月 296.39、山羊座;アセンダント 159.26、乙女座;オフセット 4。

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