Bubble

Bubble의 API Connector는 Bubble 서버에서 호출을 전송하므로 공개 키가 아닌 “서버 전용” 키가 필요해. 아래 요청은 호출이 구성하는 그대로 프로덕션으로 전송되며, Bubble의 단계는 2026년 9월 17일자 Bubble 설명서에 따라 작성되었고, API Connector 자체는 무료 요금제에 포함되어 있어.

먼저, chart 범위로 자동화 키 섹션에 설명된 대로 키를 생성해.

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. 호출 추가

컬렉션 내부에 호출을 추가하고 다음을 채워:

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>"
}

본문 아래에서 다섯 가지 매개변수 모두에서 Private 체크박스를 해제하여 애플리케이션이 이들을 설정할 수 있도록 하고, 표의 값을 기본값으로 지정해. 다음으로 Initialize call을 클릭해.

매개변수	초기화 값
`date`	`1990-05-15`
`time`	`14:30:00`
`timezone`	`Europe/Kyiv`
`latitude`	`50.45`
`longitude`	`30.52`

초기화는 Bubble에 응답 형식을 알려주는 것이며, 설명서에서는 이 다섯 가지 값을 예시 데이터로 사용하도록 요청해. 올바른 응답에는 값이 true인 ok와 planets, houses, input을 포함하는 data 객체가 포함돼.

매개변수를 추가하거나 이름을 변경한 후 초기화를 반복해야 해: 응답 스키마는 이 단계에서 기억돼.

3. 응답 읽기

초기화 후 Bubble은 유형과 포함 체크박스가 있는 응답 필드를 표시해. 가장 인기 있는 세 가지 값:

어센던트: data > houses > ascendant.
태양: data > planets의 첫 번째 항목, 그 longitude.
달: 두 번째 항목, 그 longitude.
사용된 오프셋: data > input > timezoneOffset, 위 예시에서는 4인데, 그 날짜에 키이우가 UTC+4를 사용했기 때문이야.

별자리는 경도를 30으로 나누고 내림한 값이며, 열두 이름 목록의 인덱스로 사용돼. 표현식에서: data's houses's ascendant를 30으로 나누고, 정수 부분을 취한 다음, option set 또는 열두 별자리 목록에서 숫자를 찾아. 예를 들어, 어센던트 159.26은 5, 즉 처녀자리를 나타내.

오류

워크플로우에서 오류를 처리하고 중단하지 않으려면 호출에서 Include errors in response & allow workflow actions to continue 체크박스를 선택해. Bubble은 초기화 후 이 옵션을 전환하면 응답 형식이 변경된다고 명시하므로, 초기화를 반복해야 해.

details에 timezone이 있는 400 INVALID_FIELD: 시간대가 비어 있거나, EST와 같은 약어이거나 유효한 시간대 이름이 아니야.
details에 date 또는 time이 있는 400: 형식이 YYYY-MM-DD / HH:MM:SS가 아니야. 날짜에 :formatted as 연산자를 사용하면 호출 전에 이를 수정할 수 있어.
403 ENDPOINT_NOT_IN_SCOPE: 키 범위에 chart가 없어.
429 KEY_BUDGET_EXHAUSTED: 키가 자체 예산을 소진했어. 대시보드에서 예산을 늘려.

도움이 되었나요?

Запропонувати правку

마지막 업데이트: 2026. 9. 18.