Bubble
API Connector w Bubble wysyła wywołania z serwerów Bubble, więc potrzebny jest klucz “Tylko serwer”, a nie publiczny. Zapytanie poniżej zostało wysłane na produkcję dokładnie w takiej formie, w jakiej je tworzy wywołanie; kroki w Bubble są opisane w przewodniku Bubble z dnia 2026-09-17, a sam API Connector jest dostępny w darmowym planie.
Najpierw utwórz klucz, jak opisano w sekcji Klucz do automatyzacji, z obszarem chart.
1. Stwórz kolekcję
Dział zatytułowany „1. Stwórz kolekcję”W wtyczce API Connector kliknij + New i wypełnij kolekcję:
- Collection name:
AstroWay. Przewodnik Bubble ostrzega, że nazwa kolekcji trafia do kodu klienta aplikacji, więc trzymaj ją prostą. - Authentication: Private key in header, nazwa nagłówka
X-Api-Key, wartość to twój klucz.
Jeśli zostawisz None or self-handled, dodaj klucz w Shared headers for all calls przyciskiem + Add a shared header i zaznacz Private. W obu przypadkach klucz pozostaje na serwerze.
2. Dodaj wywołanie
Dział zatytułowany „2. Dodaj wywołanie”Dodaj wywołanie wewnątrz kolekcji i wypełnij je:
-
Call name:
Natal chart. -
Use as: Action dla workflow, Data, jeśli strona odczytuje dane bezpośrednio.
-
Method:
POST. -
URL:
https://api.astroway.info/v1/chart -
Body type: JSON.
-
Body: JSON poniżej. Kątowe nawiasy to składnia parametru w Bubble i każdy z nich tworzy wpis pod ciałem.
{ "date": "<date>", "time": "<time>", "timezone": "<timezone>", "latitude": "<latitude>", "longitude": "<longitude>"}Pod ciałem odznacz Private dla wszystkich pięciu parametrów, aby aplikacja mogła je ustawiać, i podaj wartości z tabeli jako domyślne. Następnie kliknij Initialize call.
| Parametr | Wartość do inicjalizacji |
|---|---|
date | 1990-05-15 |
time | 14:30:00 |
timezone | Europe/Kyiv |
latitude | 50.45 |
longitude | 30.52 |
Inicjalizacja to to, co uczy Bubble kształtu odpowiedzi, i przewodnik prosi używać do niej przykładowych danych, czyli tych pięciu wartości. Poprawna odpowiedź zawiera ok z wartością true oraz obiekt data z planets, houses i input.
Po dodaniu lub zmianie nazwy parametru inicjalizację trzeba powtórzyć: schemat odpowiedzi jest zapamiętywany właśnie na tym etapie.
3. Przeczytaj odpowiedź
Dział zatytułowany „3. Przeczytaj odpowiedź”Po inicjalizacji Bubble wyświetla pola odpowiedzi z typem i zaznaczoną opcją włączenia. Trzy najpopularniejsze wartości:
- Ascendent:
data > houses > ascendant. - Słońce: pierwszy rekord
data > planets, jegolongitude. - Księżyc: drugi rekord, jego
longitude. - Użyty offset:
data > input > timezoneOffset, w powyższym przykładzie to4, ponieważ Kijów w tej dacie miał UTC+4.
Znak to długość podzielona przez 30 i zaokrąglona w dół, jako indeks w liście dwunastu nazw. W wyrażeniu: podziel data's houses's ascendant przez 30, weź część całkowitą i znajdź liczbę w zestawie opcji lub w liście dwunastu znaków. Na przykład Ascendent 159.26 daje 5, czyli Panna.
Zaznacz w wywołaniu opcję Include errors in response & allow workflow actions to continue, jeśli chcesz obsługiwać błędy w workflow, a nie przerywać go. Bubble zauważa, że przełączenie tej opcji po inicjalizacji zmienia format odpowiedzi, więc inicjalizację trzeba powtórzyć.
400 INVALID_FIELDztimezonewdetails: strefa jest pusta, to skrót w styluESTlub nie jest nazwą strefy.400zdatelubtimewdetails: format nie jestYYYY-MM-DD/HH:MM:SS. Operator:formatted asna dacie naprawia to przed wywołaniem.403 ENDPOINT_NOT_IN_SCOPE: w obszarze klucza nie machart.429 KEY_BUDGET_EXHAUSTED: klucz wyczerpał swój budżet; podnieś go w dashboardzie.