Tích hợp không mã

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

Mọi thứ trên các trang này được thực hiện dựa trên môi trường sản xuất ngày 2026-09-17. Workflow cho n8n đã được nhập và chạy trong n8n thực tế; các bước cho Zapier và Make được viết theo tài liệu riêng của các công cụ này, và các yêu cầu mà chúng tạo ra đã được gửi đi đúng như vậy.

Nguồn gốc yêu cầu

Điều này quyết định loại khóa cần thiết.

Zapier, Make và n8n gửi yêu cầu từ máy chủ của họ. Cần có khóa “Chỉ máy chủ” với phạm vi endpoint và ngân sách, như mô tả bên dưới. Hướng dẫn: Zapier, Make, n8n.
Bubble cũng gửi yêu cầu từ máy chủ của họ, và khóa nằm trong header, nơi nó được giữ lại: Bubble.
FlutterFlow được biên dịch thành một ứng dụng mà người dùng giữ, vì vậy cuộc gọi phải được thực hiện riêng tư: FlutterFlow.
Wix, Squarespace, Shopify, Webflow và Tilda hiển thị trang trong trình duyệt của khách truy cập. Hãy nhúng widget, không phải khóa: trình tạo trang web.
WordPress truy cập từ máy chủ của riêng bạn. Plugin AstroWay sẽ quản lý khóa.

Khóa cho tự động hóa

Bất kỳ ai có thể chỉnh sửa Zap, kịch bản hoặc workflow đều có thể thấy khóa bên trong. Vì vậy, hãy cấp cho mỗi tự động hóa một khóa riêng và giới hạn nó vào những gì nó thực hiện.

Trong bảng điều khiển, mở API-keys và nhấp vào Khóa mới. Đặt tên cho nó theo tự động hóa, ví dụ zapier-intake-form.
Trong trường Khóa này sẽ được sử dụng ở đâu?, hãy giữ nguyên Chỉ máy chủ.
Sao chép khóa và lưu lại: hộp thoại chỉ hiển thị toàn bộ khóa một lần. Nếu khóa bị mất, nhấp vào Cập nhật khóa trong menu khóa: bạn sẽ nhận được khóa mới, khóa cũ sẽ ngừng hoạt động.
Trong menu khóa, mở Phạm vi endpoint và liệt kê các đường dẫn mà tự động hóa gọi, mỗi đường dẫn một dòng: chart cho biểu đồ sinh, public/horoscope/* cho tử vi hàng ngày.
Trong cùng menu đó, mở Đặt ngân sách và chỉ định số lượng credit mà khóa này có thể chi tiêu mỗi chu kỳ.

Cuộc gọi nằm ngoài danh sách sẽ nhận 403 ENDPOINT_NOT_IN_SCOPE. Khóa đã hết ngân sách sẽ nhận 429 KEY_BUDGET_EXHAUSTED, ngay cả khi tài khoản vẫn còn credit, vì vậy một tự động hóa bị lặp sẽ dừng lại ở số đã chỉ định. Cả hai giới hạn này đều hoạt động trên mọi gói cước và được mô tả trong phần Xác thực.

Gửi thời điểm sinh, không phải độ lệch múi giờ

Biểu mẫu cung cấp ngày, giờ trên đồng hồ và địa điểm. Gửi chúng như sau:

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezone": "Europe/Kyiv",
  "latitude": 50.45,
  "longitude": 30.52
}

timezone là tên múi giờ, và máy chủ sẽ tự tìm độ lệch từ UTC mà đồng hồ đã giữ vào ngày đó, cùng với giờ tiết kiệm ánh sáng ban ngày. Kyiv vào 1990-05-15 sử dụng UTC+4, không phải +3: đây chính là lỗi mà độ lệch nhập thủ công gây ra. Gửi auto để lấy múi giờ từ tọa độ.
Không có timezone và không có độ lệch biểu đồ được tính cho UTC. Phản hồi vẫn là 200, vì vậy hãy kiểm tra xem trường đã được ánh xạ chưa.
timezone trống bị từ chối với 400, vì nếu không, trường biểu mẫu chưa điền sẽ được hiểu là UTC.
date ở định dạng YYYY-MM-DD, time ở định dạng HH:MM:SS. Nếu biểu mẫu lưu trữ chúng khác, hãy sử dụng định dạng ngày trong chính công cụ đó.
Các số có thể đến dưới dạng văn bản. "latitude": "50.45" được chấp nhận, và đây là cách hầu hết các trường biểu mẫu gửi chúng.
API không mã hóa địa lý. Tọa độ phải đến từ biểu mẫu hoặc từ bước mã hóa địa lý trong công cụ. Trường city chỉ là một nhãn.

Các quy tắc cho việc chuyển đổi đồng hồ và ngày trước năm 1970 được mô tả trong định dạng trường.

Cách chuyển đổi kinh độ thành cung hoàng đạo

POST /v1/chart phản hồi bằng độ dọc theo cung hoàng đạo, trong một đối tượng { "ok": true, "data": { ... } }. Cung hoàng đạo bằng floor(longitude / 30), tính từ số không:

0 Bạch Dương, 1 Kim Ngưu, 2 Song Tử, 3 Cự Giải, 4 Sư Tử, 5 Xử Nữ, 6 Thiên Bình, 7 Bọ Cạp, 8 Nhân Mã, 9 Ma Kết, 10 Bảo Bình, 11 Song Ngư.

Ba giá trị phổ biến nhất nằm ở đâu:

Mặt Trời: mục nhập trong data.planets với "name": "Sun", đầu tiên.
Mặt Trăng: mục nhập trong data.planets với "name": "Moon", thứ hai.
Cung Mọc: data.houses.ascendant.
Độ lệch múi giờ đã sử dụng: data.input.timezoneOffset.

Đối với ví dụ trên: Mặt Trời 54.34, vậy là Kim Ngưu; Mặt Trăng 296.39, Ma Kết; Cung Mọc 159.26, Xử Nữ; độ lệch 4.

Chi phí

POST /v1/chart tốn 20 credit. Bảng đầy đủ trên trang Chi phí endpoint.
Cùng một yêu cầu, nếu được gửi lại trong vòng năm phút, sẽ được trả về từ bộ nhớ cache và không bị tính phí. Một lần chạy thử nghiệm lặp lại cùng một nội dung sẽ không tiêu tốn ngân sách.
GET /v1/public/horoscope/daily không tốn credit. Không có khóa hoặc với khóa trên gói Free, nó được tính vào giới hạn 30 yêu cầu mỗi giờ từ một địa chỉ IP, và các nền tảng tự động hóa chia sẻ địa chỉ của họ giữa các khách hàng. Khóa trên gói trả phí có giới hạn riêng.