Bubble
API Connector a Bubble-ben a Bubble szervereiről küld hívásokat, ezért itt egy „Csak szerver” kulcsra van szükség, nem nyilvánosra. Az alábbi kérés pontosan abban a formában kerül elküldésre a produkcióba, ahogyan a hívás összeállítja; a Bubble lépései a Bubble 2026-09-17-i kézikönyve alapján íródtak, és maga az API Connector az ingyenes csomagban szerepel.
Először hozz létre egy kulcsot, ahogyan az az Automatizálási kulcs szakaszban le van írva, chart hatókörrel.
1. Hozz létre egy gyűjteményt
Szekció neve “1. Hozz létre egy gyűjteményt”Az API Connector bővítményben kattints a + New gombra, és töltsd ki a gyűjteményt:
- Collection name:
AstroWay. A Bubble kézikönyve figyelmeztet, hogy a gyűjtemény neve bekerül az alkalmazás kliensoldali kódjába, ezért tartsd egyszerűen. - Authentication: Private key in header, a fejléc neve
X-Api-Key, az érték a kulcsod.
Ha None or self-handled opciót hagysz, add hozzá a kulcsot a Shared headers for all calls részhez a + Add a shared header gombbal, és jelöld be a Private opciót. Mindkét esetben a kulcs a szerveren marad.
2. Hívás hozzáadása
Szekció neve “2. Hívás hozzáadása”Adj hozzá egy hívást a gyűjteményen belül, és töltsd ki:
-
Call name:
Natal chart. -
Use as: Action a munkafolyamathoz, Data, ha az oldal közvetlenül olvassa az adatokat.
-
Method:
POST. -
URL:
https://api.astroway.info/v1/chart -
Body type: JSON.
-
Body: Az alábbi JSON. A szögletes zárójelek a Bubble paraméterszintaxisát jelentik, és mindegyik létrehoz egy bejegyzést a törzs alatt.
{ "date": "<date>", "time": "<time>", "timezone": "<timezone>", "latitude": "<latitude>", "longitude": "<longitude>"}A törzs alatt vedd ki a Private jelölést mind az öt paraméterről, hogy az alkalmazás beállíthassa őket, és add meg a táblázatban szereplő értékeket alapértelmezettként. Ezután kattints az Initialize call gombra.
| Paraméter | Inicializálási érték |
|---|---|
date | 1990-05-15 |
time | 14:30:00 |
timezone | Europe/Kyiv |
latitude | 50.45 |
longitude | 30.52 |
Az inicializálás az, ami megtanítja a Bubble-nek a válasz formáját, és a kézikönyv azt kéri, hogy ehhez mintadatokat használj, amelyek ez az öt érték. A helyes válasz tartalmazza az ok értéket true-val, és egy data objektumot planets, houses és input értékekkel.
Paraméter hozzáadása vagy átnevezése után az inicializálást meg kell ismételni: a válasz sémája pontosan ezen a lépésen memorizálódik.
3. Olvasd el a választ
Szekció neve “3. Olvasd el a választ”Az inicializálás után a Bubble megjeleníti a válasz mezőit típussal és bejelölési lehetőséggel. Három legnépszerűbb érték:
- Aszcendens:
data > houses > ascendant. - Nap: az első bejegyzés
data > planets, annaklongitudeértéke. - Hold: a második bejegyzés, annak
longitudeértéke. - Használt eltolás:
data > input > timezoneOffset, a fenti példában ez4, mert Kijev azon a dátumon UTC+4-et használt.
A jegy a hosszúság 30-cal elosztva és lefelé kerekítve, mint egy index egy tizenkét nevű listában. Kifejezésben: oszd el a data's houses's ascendant értéket 30-cal, vedd az egész részt, és keresd meg a számot egy opciókészletben vagy egy tizenkét jegyből álló listában. Például az Aszcendens 159.26 értéke 5-öt ad, azaz a Szüzet.
Hibák
Szekció neve “Hibák”Jelöld be a hívásnál az Include errors in response & allow workflow actions to continue opciót, ha a munkafolyamatban szeretnéd kezelni a hibákat, ahelyett, hogy leállítanád azt. A Bubble megjegyzi, hogy ennek az opciónak az inicializálás utáni átkapcsolása megváltoztatja a válasz formátumát, ezért az inicializálást meg kell ismételni.
400 INVALID_FIELDtimezoneadetails-ben: a zóna üres, ez egy rövidítés, mint azEST, vagy nem egy zóna neve.400datevagytimeadetails-ben: a formátum nemYYYY-MM-DD/HH:MM:SS. A:formatted asoperátor a dátumon kijavítja ezt a hívás előtt.403 ENDPOINT_NOT_IN_SCOPE: a kulcs hatókörében nincschart.429 KEY_BUDGET_EXHAUSTED: a kulcs kimerítette a saját költségvetését; emeld meg a műszerfalon.