Bỏ qua để đến nội dung
AstroWay/api v2.356.0 · vi
tất cả hệ thống hoạt động bình thường

Bubble

Last updated Xem dưới dạng Markdown Thiết lập tác nhân

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.

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ủ.

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

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, longitude của nó.
  • Mặt trăng: bản ghi thứ hai, longitude củ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_FIELD với timezone trong details: múi giờ trống, đây là viết tắt như EST hoặc không phải tên múi giờ.
  • 400 với date hoặc time trong details: định dạng không phải YYYY-MM-DD / HH:MM:SS. Toán tử :formatted as trê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.