Nhà xây dựng trang web
Trình tạo website hiển thị trang của bạn trong trình duyệt của khách, vì vậy quy tắc ngược lại với hướng dẫn cho tự động hoá: bạn chèn widget, không phải key. Cả hai snippet dưới đây đã được tải từ trang trên miền khác trong Chrome 2026-09-17, và cả hai đều hiển thị.
Chèn một trong các snippet
Phần tiêu đề “Chèn một trong các snippet”Iframe thông thường, khi kích thước đã biết:
<iframe src="https://api.astroway.info/v1/embed/moon-phase?theme=light&lang=uk" width="320" height="360" style="border:0"></iframe>Loader, khi không muốn tự chọn kích thước: nó thay thế mình bằng iframe và điều chỉnh chiều cao theo nội dung qua postMessage.
<script src="https://cdn.astroway.info/embed.js" data-widget="moon-phase" data-lang="uk" data-theme="light"></script>Mười lăm widget, tất cả các tham số và nút sao chép cho mỗi cái trên trang Widgets. Bất kỳ thuộc tính data-* nào cũng trở thành tham số truy vấn.
Nơi chèn mã
Phần tiêu đề “Nơi chèn mã”| Trình tạo | Cần tìm gì |
|---|---|
| Wix | element chèn mã HTML |
| Squarespace | khối mã |
| Shopify | phần custom liquid hoặc trình chỉnh sửa mã theme |
| Webflow | phần tử embed |
| Tilda | khối mã HTML, T123 |
Đối với Wix và Squarespace, các liên kết dẫn tới tài liệu của họ; ba phần còn lại được đặt tên theo chức năng vì trang tài liệu của chúng không mở bằng kiểm tra tự động, và chúng tôi sẽ không liên kết tới những nguồn chưa được xác minh.
Key không cần thiết và không được chấp nhận
Phần tiêu đề “Key không cần thiết và không được chấp nhận”Các endpoint /v1/embed/* là công khai. Key trong thuộc tính của trang sẽ bị mọi khách nhìn thấy, vì vậy loader bỏ qua nó và ghi thông báo vào console.
Giới hạn: 30 yêu cầu mỗi giờ từ IP của khách, phản hồi được cache trong năm phút. Vì vậy trang có nhiều khách sẽ hoạt động tốt, nhưng một khách liên tục tải lại sẽ không.
Những gì trang không thể gọi
Phần tiêu đề “Những gì trang không thể gọi”Trình duyệt trên miền khác chỉ nhận được phản hồi từ /v1/public/* và /v1/embed/*. Các endpoint khác dưới /v1/* bị từ chối preflight: từ trang trên miền khác POST /v1/chart trả về mà không có header access-control-allow-origin, Chrome đã chặn, trong khi POST /v1/public/chart từ cùng trang trả về 200.
Vì vậy nếu muốn khách nhập dữ liệu sinh nhật của mình và xem bản đồ, hãy dùng các endpoint không cần key hoặc widget‑máy tính bản đồ sinh tính trực tiếp trong trình duyệt. Mọi thứ cần key bí mật sẽ chạy trên server: server của bạn hoặc một trong các công cụ trong mục Tích hợp không code.