# コード不要の統合

これらのページのすべてのコンテンツは2026-09-17のプロダクション環境に対して実行されています。n8nのワークフローはインポートされ、実際のn8nで実行されています。ZapierとMakeの手順はこれらのツールの独自ドキュメントに基づいて作成され、それらが作成するリクエストはそのまま送信されています。

## リクエストの送信元

どのキーが必要かは、リクエストの送信元によって異なります。

- **Zapier、Make、n8n**は自らのサーバーからリクエストを送信します。以下に記述されているように、エンドポイントのスコープと予算を持つ「サーバーのみ」キーが必要です。手順: [Zapier](/integrations/zapier/)、[Make](/integrations/make/)、[n8n](/integrations/n8n/)。
- **Bubble**も自らのサーバーからリクエストを送信し、キーはヘッダーに含まれ、そこに残ります: [Bubble](/integrations/bubble/)。
- **FlutterFlow**はユーザーが保持するアプリにコンパイルされるため、呼び出しはプライベートである必要があります: [FlutterFlow](/integrations/flutterflow/)。
- **Wix、Squarespace、Shopify、Webflow、Tilda**は訪問者のブラウザにページを表示します。キーではなくウィジェットを埋め込んでください: [サイトビルダー](/integrations/site-builders/)。
- **WordPress**はあなた自身のサーバーからリクエストします。キーは[AstroWayプラグイン](https://wordpress.org/plugins/astroway/)が管理します。

<Aside type="caution">
公開キー `pk_` はZapier、Make、またはn8nでは機能しません。これらのツールはoriginを送信しないため、リクエストはoriginのないリストから拒否されます。Webサイトのページからは `/v1/public/*` と `/v1/embed/*` のみを取得します。
</Aside>

## 自動化のためのキー

Zap、スクリプト、またはワークフローを編集できるすべての人は、キーを内部で確認できます。そのため、各自動化に固有のキーを割り当て、それが実行する操作に制限を設定してください。

1. ダッシュボードで[APIキー](https://api.astroway.info/dashboard/keys)を開き、**新しいキー**をクリックします。自動化に合わせて名前を付け、例えば `zapier-intake-form` とします。
2. **このキーはどこで使用されますか？**フィールドで**サーバーのみ**のままにします。
3. キーをコピーします。ダイアログではキーが一度だけ完全に表示されます。後でキーメニューの**表示**からアクセスできます。
4. キーメニューで**エンドポイントスコープ**を開き、自動化が呼び出すパスを1行ずつリストアップします: `chart`はnatal chart（出生図）、`public/horoscope/*`はdaily horoscopes（日占い）用です。
5. 同じメニューで**予算を設定**を開き、このキーがサイクルあたりに消費できるクレジット数を指定します。

リスト外の呼び出しは `403 ENDPOINT_NOT_IN_SCOPE` を返します。予算を使い切ったキーは、アカウントにクレジットが残っていても `429 KEY_BUDGET_EXHAUSTED` を返すため、ループした自動化は指定された数で停止します。両方の制限はすべての料金プランで機能し、[認証](/authentication/)セクションで説明されています。

## 誕生時刻を送信する、オフセットではない

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

```json
{
  "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年以前の時計の変更と日付の変換ルールは[フィールド形式](/agent-setup/field-formats/#timezone-名前-代わりにオフセット)で説明されています。

## 経度を星座に変換する方法

`POST /v1/chart` は黄道沿いの度数で応答し、`{ "ok": true, "data": { ... } }` のラップ内にあります。サインは `floor(longitude / 30)` で、ゼロから数えます:

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

最も一般的な3つの値の位置:

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

上記の例の場合: 太陽54.34、つまり牡牛座; 月296.39、山羊座; Ascendant 159.26、乙女座; オフセット4。

## 費用はいくらですか

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