Przejdź do głównej zawartości
AstroWay/api v2.356.2 · pl
wszystkie systemy w normie

Bubble

Last updated Otwórz jako Markdown Konfiguracja agenta

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.

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.

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.

ParametrWartość do inicjalizacji
date1990-05-15
time14:30:00
timezoneEurope/Kyiv
latitude50.45
longitude30.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.

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, jego longitude.
  • Księżyc: drugi rekord, jego longitude.
  • Użyty offset: data > input > timezoneOffset, w powyższym przykładzie to 4, 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_FIELD z timezone w details: strefa jest pusta, to skrót w stylu EST lub nie jest nazwą strefy.
  • 400 z date lub time w details: format nie jest YYYY-MM-DD / HH:MM:SS. Operator :formatted as na dacie naprawia to przed wywołaniem.
  • 403 ENDPOINT_NOT_IN_SCOPE: w obszarze klucza nie ma chart.
  • 429 KEY_BUDGET_EXHAUSTED: klucz wyczerpał swój budżet; podnieś go w dashboardzie.