Tiện ích chiêm tinh cho trang web
Các widget HTML công khai GET /v1/embed/* trả về một đoạn iframe hoàn chỉnh - vòng tròn SVG, tử vi, thần số học, v.v. Không cần API key, giới hạn theo IP của khách truy cập (120 request mỗi giờ, tách biệt với /v1/public/*, nên trang có nhiều widget sẽ không chạm giới hạn), cache public, max-age=300. Phù hợp cho các trang marketing; với production có traffic cao, hãy dùng SDK.
<iframe src="https://api.astroway.info/v1/embed/wheel?date=1990-05-15&time=14:30&lat=50.45&lng=30.52&tz=2&theme=dark" width="460" height="560" style="border:0"></iframe>Bắt đầu từ đâu
Phần tiêu đề “Bắt đầu từ đâu”Cách nhúng phụ thuộc vào nền tảng website của bạn. Nội dung giống nhau, chỉ khác ở lượng công việc còn lại dành cho bạn.
| Website | Nên dùng gì |
|---|---|
| WordPress | Plugin AstroWay: 18 shortcode và 26 block Gutenberg. Mười một widget hoạt động ngay sau khi cài đặt, không cần key. |
| WordPress với Elementor | AstroWay for Elementor: bảy widget ngay trong trình soạn thảo, kéo-thả. |
| Tilda, Squarespace, Wix, HTML thuần | Script loader bên dưới hoặc <iframe> có sẵn từ gallery. Sao chép bằng một nút bấm. |
| Frontend tự xây | Cùng các endpoint /v1/embed/*, hoặc SDK nếu bạn cần kiểm soát hoàn toàn layout. |
Các plugin trả về cùng nội dung như các endpoint trên trang này, nhưng hiển thị theo giao diện theme của bạn và không yêu cầu tự chỉnh chiều cao thủ công.
Widget riêng: công cụ tính bản đồ sao
Phần tiêu đề “Widget riêng: công cụ tính bản đồ sao”Các widget trên trang này hiển thị những gì bạn đã biết: bạn truyền vào ngày, giờ và địa điểm. Nếu bạn muốn chính khách truy cập nhập dữ liệu, có một widget khác của chúng tôi, công cụ tính bản đồ sao (gói @astroway/widget). Đó là form, phép tính và vòng tròn trong một lần nhúng, mười ngôn ngữ, theme sáng và tối.
Khác biệt không nằm ở giao diện, mà ở nơi diễn ra phép tính. Công cụ tính chạy ngay trong trình duyệt của khách truy cập, và dữ liệu ngày sinh không hề được gửi lên server. Các widget /v1/embed/* do chúng tôi tính toán, nên tham số của chúng hiển thị trong URL của iframe.
| Bạn cần gì | Chọn gì |
|---|---|
| Khách truy cập tự nhập dữ liệu ngày sinh | Công cụ tính @astroway/widget |
| Dữ liệu ngày sinh không được rời khỏi trình duyệt | Công cụ tính @astroway/widget |
| Tử vi, transit, tarot, thần số học, panchang và mười hai loại khác | Các widget trên trang này |
| Hai mươi ngôn ngữ thay vì mười | Các widget trên trang này |
Script loader
Phần tiêu đề “Script loader”Nếu bạn không muốn tự tính chiều cao iframe, hãy dùng loader: nó chèn iframe thay thế chính nó và tự động điều chỉnh chiều cao theo nội dung, vì widget báo kích thước của mình qua postMessage.
<script src="https://cdn.astroway.info/embed.js" data-widget="wheel" data-date="1990-05-15" data-time="14:30" data-lat="50.45" data-lng="30.52" data-tz="3"></script>Bất kỳ thuộc tính data-* nào cũng trở thành tham số query, nên data-theme="light" và data-lang="en" hoạt động giống như trong ví dụ iframe. data-height="500" cố định chiều cao và tắt chế độ tự điều chỉnh. Nhiều widget trên cùng một trang không ảnh hưởng lẫn nhau.
Không cần key và key cũng không được chấp nhận. Các endpoint /v1/embed/* là công khai, còn key trong thuộc tính sẽ lộ ra trong mã nguồn trang. Loader bỏ qua các thuộc tính như vậy kèm cảnh báo trong console.
Nên dùng URL nào
Phần tiêu đề “Nên dùng URL nào”| File | Cache | Dành cho ai |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 phút | Lựa chọn mặc định. Bạn nhận bản sửa lỗi tự động. |
https://cdn.astroway.info/embed.v1.js | 1 năm, immutable | Nếu bạn cần tính bất biến. Chỉ cập nhật vì lý do bảo mật; thay đổi hành vi sẽ nằm trong embed.v2.js. |
Gallery widget
Phần tiêu đề “Gallery widget”Xem trực tiếp cả 16 widget. Chọn theme và ngôn ngữ nội dung, chuyển snippet giữa <iframe> và loader <script> rồi sao chép mã hoàn chỉnh.
Tham số chung
Phần tiêu đề “Tham số chung”Tất cả widget đều chấp nhận:
| Tham số | Giá trị | Mặc định | Mô tả |
|---|---|---|---|
theme | dark · light · console | dark | Bảng màu. |
lang | uk · en · +18 ngôn ngữ | uk | Ngôn ngữ nội dung. Cũng được đọc từ header Accept-Language. |
disclaimer | 1 · true · yes | tắt | Thêm vào footer tuyên bố miễn trừ về tính chất giải trí - tham khảo của nội dung (không phải tư vấn y khoa, tâm lý, tài chính hay pháp lý). |
Các widget
Phần tiêu đề “Các widget”| Widget | Endpoint | Tham số riêng |
|---|---|---|
| Tử vi hôm nay | GET /embed/daily-horoscope | sign, date |
| Vòng tròn bản đồ sao | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Dòng thời gian transit | GET /embed/transit-timeline | date, days (tối đa 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Kundli Vệ Đà | GET /embed/kundli | date, time, lat, lng, tz |
| Mini-chart | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Hành tinh của ngày | GET /embed/planet-of-day | date |
| Pha Mặt Trăng | GET /embed/moon-phase | date |
| Tarot hôm nay | GET /embed/daily-tarot | date |
| Dự báo tháng | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Transit bầu trời | GET /embed/transit | date |
| Thần số học | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (tọa độ bắt buộc) |
| Synastry | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Lịch Mặt Trăng | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Trải bài tarot | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Định dạng: ngày - YYYY-MM-DD, giờ - HH:MM, tz - độ lệch so với UTC tính bằng giờ. Các tham số không truyền sẽ được điền giá trị mặc định hợp lý (ngày hiện tại, buổi trưa, xích đạo).