Bubble
API Connector trong Bubble gửi các yêu cầu từ máy chủ của Bubble, vì vậy ở đây cần khóa “Chỉ máy chủ”, không phải công khai. Yêu cầu dưới đây được gửi tới production đúng như cách nó được gọi; các bước trong Bubble được viết theo hướng dẫn Bubble tính đến ngày 2026-09-17, và API Connector được liệt kê trong gói miễn phí.
Đầu tiên tạo khóa, như mô tả trong mục Khóa cho tự động hóa, với phạm vi chart.
1. Tạo bộ sưu tập
Phần tiêu đề “1. Tạo bộ sưu tập”Trong plugin API Connector, nhấn + New và điền thông tin bộ sưu tập:
- Collection name:
AstroWay. Hướng dẫn Bubble cảnh báo rằng tên bộ sưu tập sẽ xuất hiện trong mã client của ứng dụng, vì vậy hãy giữ nó đơn giản. - Authentication: Private key in header, tên header là
X-Api-Key, giá trị là khóa của bạn. - Nếu để None or self-handled, thêm khóa vào Shared headers for all calls bằng nút + Add a shared header và đánh dấu Private. Trong cả hai trường hợp, khóa vẫn ở trên máy chủ.
2. Thêm lời gọi
Phần tiêu đề “2. Thêm lời gọi”Thêm lời gọi bên trong bộ sưu tập và điền thông tin:
-
Call name:
Natal chart. -
Use as: Action cho workflow, Data, nếu trang đọc dữ liệu trực tiếp.
-
Method:
POST. -
URL:
https://api.astroway.info/v1/chart -
Body type: JSON.
-
Body: JSON dưới đây. Dấu ngoặc nhọn là cú pháp tham số trong Bubble, và mỗi dấu tạo một bản ghi dưới phần body.
{ "date": "<date>", "time": "<time>", "timezone": "<timezone>", "latitude": "<latitude>", "longitude": "<longitude>"}Trong phần body, bỏ dấu Private khỏi năm tham số, để ứng dụng có thể đặt chúng, và nhập giá trị từ bảng làm mặc định. Sau đó nhấn Initialize call.
| Tham số | Giá trị để khởi tạo |
|---|---|
date | 1990-05-15 |
time | 14:30:00 |
timezone | Europe/Kyiv |
latitude | 50.45 |
longitude | 30.52 |
Khởi tạo là quá trình mà Bubble học dạng phản hồi, và hướng dẫn yêu cầu sử dụng dữ liệu mẫu, tức là năm giá trị này. Phản hồi đúng chứa ok với giá trị true và đối tượng data có planets, houses và input.
Sau khi thêm hoặc đổi tên tham số, cần lặp lại khởi tạo: schema phản hồi được ghi nhớ ở bước này.
3. Đọc phản hồi
Phần tiêu đề “3. Đọc phản hồi”Sau khi khởi tạo, Bubble hiển thị các trường phản hồi với kiểu và dấu bật. Ba giá trị phổ biến nhất:
- Cung lên:
data > houses > ascendant. - Mặt trời: bản ghi đầu tiên
data > planets,longitudecủa nó. - Mặt trăng: bản ghi thứ hai,
longitudecủa nó. - Offset đã sử dụng:
data > input > timezoneOffset, trong ví dụ trên là4, vì Kyiv vào ngày đó có UTC+4.
Dấu là kinh độ chia cho 30 và làm tròn xuống, như chỉ số trong danh sách mười hai tên. Trong công thức: chia data's houses's ascendant cho 30, lấy phần nguyên và tìm số trong option set hoặc danh sách mười hai dấu. Ví dụ, Cung lên 159.26 cho kết quả 5, tức là Xử Nữ.
Đánh dấu Include errors in response & allow workflow actions to continue trên lời gọi nếu muốn xử lý lỗi trong workflow mà không dừng nó. Bubble lưu ý rằng việc chuyển đổi tùy chọn này sau khi khởi tạo sẽ thay đổi định dạng phản hồi, vì vậy cần lặp lại khởi tạo.
400 INVALID_FIELDvớitimezonetrongdetails: múi giờ trống, đây là viết tắt nhưESThoặc không phải tên múi giờ.400vớidatehoặctimetrongdetails: định dạng không phảiYYYY-MM-DD/HH:MM:SS. Toán tử:formatted astrên ngày sẽ sửa lại cho lời gọi.403 ENDPOINT_NOT_IN_SCOPE: phạm vi khóa không cóchart.429 KEY_BUDGET_EXHAUSTED: khóa đã hết ngân sách riêng; tăng lên trong dashboard.