Bubble
BubbleのAPI ConnectorはBubbleサーバーから呼び出しを送信するため、ここでは公開キーではなく「サーバーのみ」のキーが必要になるよ。以下のリクエストは、呼び出しが構成するそのままの形式で本番環境に送信される。Bubbleのステップは2026-09-17時点のBubbleマニュアルに基づいて記述されており、API Connector自体は無料プランに含まれているよ。
まず、自動化キーセクションで説明されているように、chartスコープでキーを作成してね。
1. コレクションを作成する
Section titled “1. コレクションを作成する”API Connectorプラグインで**+ New**をクリックし、コレクションを記入してね：
- Collection name:
AstroWay。Bubbleマニュアルは、コレクション名がアプリケーションのクライアントコードに含まれるため、シンプルに保つよう警告しているよ。 - Authentication: Private key in header、ヘッダー名
X-Api-Key、値はあなたのキー。
None or self-handledのままにする場合、+ Add a shared headerボタンでShared headers for all callsにキーを追加し、Privateにチェックを入れてね。どちらの場合も、キーはサーバーに残るよ。
2. 呼び出しを追加する
Section titled “2. 呼び出しを追加する”コレクション内に呼び出しを追加し、それを記入してね：
-
Call name:
Natal chart。 -
Use as: ワークフロー用にはAction、ページが直接データを読み込む場合はData。
-
Method:
POST。 -
URL:
https://api.astroway.info/v1/chart -
Body type: JSON。
-
Body: 以下のJSON。角括弧はBubbleのパラメータ構文であり、それぞれがボディの下にエントリを作成するよ。
{ "date": "<date>", "time": "<time>", "timezone": "<timezone>", "latitude": "<latitude>", "longitude": "<longitude>"}ボディの下で、アプリケーションがそれらを設定できるように、5つのパラメータすべてからPrivateのチェックを外してね。そして表の値をデフォルトとして指定するんだ。次にInitialize callをクリックしてね。
| パラメータ | 初期化用の値 |
|---|---|
date | 1990-05-15 |
time | 14:30:00 |
timezone | Europe/Kyiv |
latitude | 50.45 |
longitude | 30.52 |
初期化とは、Bubbleに応答の形式を教えるものであり、マニュアルは、そのためにサンプルデータを使用するよう求めているよ。これら5つの値がそれにあたるんだ。正しい応答には、値がtrueのokと、planets、houses、inputを含むdataオブジェクトが含まれるよ。
パラメータを追加または名前変更した後、初期化を繰り返す必要があるよ。応答スキーマはこのステップで記憶されるためなんだ。
3. 応答を読み取る
Section titled “3. 応答を読み取る”初期化後、Bubbleはタイプと包含チェックボックス付きで応答フィールドを表示するよ。最も一般的な3つの値は次のとおり：
- アセンダント:
data > houses > ascendant。 - 太陽:
data > planetsの最初のエントリ、そのlongitude。 - 月: 2番目のエントリ、その
longitude。 - 使用されたオフセット:
data > input > timezoneOffset。上記の例では4だよ。その日付のキエフはUTC+4だったためなんだ。
サインは、経度を30で割って切り捨てたものであり、12の名称のリストにおけるインデックスとして機能するよ。式では、data's houses's ascendantを30で割り、整数部分を取り、option setまたは12のサインのリストでその数を見つけるんだ。例えば、アセンダント159.26は5、つまり乙女座を与えるよ。
ワークフローの失敗を処理したい場合、それを停止させるのではなく、呼び出しでInclude errors in response & allow workflow actions to continueにチェックを入れてね。Bubbleは、初期化後にこのオプションを切り替えると応答の形式が変わるため、初期化を繰り返す必要があると述べているよ。
400 INVALID_FIELDとdetailsにtimezone: ゾーンが空であるか、ESTのような略語であるか、ゾーン名ではない。400とdetailsにdateまたはtime: 形式がYYYY-MM-DD/HH:MM:SSではない。日付に対する:formatted as演算子が、呼び出し前にこれを修正するよ。403 ENDPOINT_NOT_IN_SCOPE: キーのスコープにchartがない。429 KEY_BUDGET_EXHAUSTED: キーが自身の予算を使い果たした。ダッシュボードでそれを引き上げてね。