Astrologiczne widgety na stronę
Publiczne HTML-widżety GET /v1/embed/* zwracają gotowy fragment iframe - koło SVG, horoskop, numerologię itp. Bez klucza API, limit po IP odwiedzającego (120 zapytań na godzinę, osobno od /v1/public/*, więc strona z kilkoma widżetami nie napotyka limitu), cache public, max-age=300. Nadają się do stron marketingowych; do produkcji o dużym ruchu użyj 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>Od czego zacząć
Dział zatytułowany „Od czego zacząć”Sposób wstawiania zależy od tego, na czym zbudowana jest twoja strona. Treść jest taka sama, różnica jedynie w tym, ile pracy zostaje po tobie.
| Strona | Co umieścić |
|---|---|
| WordPress | Wtyczka AstroWay: 18 shortcode’ów i 26 bloków Gutenberg. Jedenaście widżetów działa od razu po instalacji, bez klucza. |
| WordPress z Elementor | AstroWay for Elementor: siedem widżetów po prostu w edytorze, metodą przeciągnij‑i‑upuść. |
| Tilda, Squarespace, Wix, zwykły HTML | Skrypt‑loader poniżej lub gotowy <iframe> z galerii. Kopiowany jednym przyciskiem. |
| Własny frontend | Te same endpointy /v1/embed/*, lub SDK, jeśli potrzebna jest pełna kontrola nad markupem. |
Wtyczki zwracają tę samą treść, co endpointy na tej stronie, ale renderują ją w stylu twojego motywu i nie wymagają ręcznego dopasowywania wysokości.
Oddzielny widżet: kalkulator karty natalnej
Dział zatytułowany „Oddzielny widżet: kalkulator karty natalnej”Widżety na tej stronie rysują to, co już znasz: datę, czas i miejsce podajesz ty. Jeśli potrzebne jest, aby dane wprowadzał sam odwiedzający, mamy inny nasz widżet, kalkulator karty natalnej (pakiet @astroway/widget). To formularz, obliczenia i koło jedną wstawką, dziesięć języków, jasny i ciemny motyw.
Różnica nie leży w wyglądzie, ale w tym, gdzie odbywa się obliczenie. Kalkulator liczy w przeglądarce odwiedzającego, a dane urodzenia nie są w ogóle wysyłane na serwer. Widżety /v1/embed/* liczymy my, więc ich parametry są widoczne w adresie iframe.
| Co potrzebujesz | Co wziąć |
|---|---|
| Odwiedzający wprowadza własne dane urodzenia | Kalkulator @astroway/widget |
| Dane urodzenia nie mają opuszczać przeglądarki | Kalkulator @astroway/widget |
| Horoskop, tranzyty, tarot, numerologia, panchang i jeszcze dwanaście typów | Widżety na tej stronie |
| Dwadzieścia języków zamiast dziesięciu | Widżety na tej stronie |
Skrypt‑loader
Dział zatytułowany „Skrypt‑loader”Jeśli nie chcesz sam liczyć wysokość iframe, podłącz loader: wstawia iframe zamiast siebie i automatycznie dopasowuje wysokość do treści, ponieważ widżet zgłasza swój rozmiar przez 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>Każdy atrybut data-* staje się parametrem zapytania, więc data-theme="light" i data-lang="en" działają tak samo, jak w przykładzie z iframe. data-height="500" ustawia stałą wysokość i wyłącza automatyczne dopasowanie. Kilka widżetów na jednej stronie nie przeszkadza sobie nawzajem.
Klucz nie jest potrzebny i nie jest akceptowany. Endpointy /v1/embed/* są publiczne, a klucz w atrybucie trafiłby do kodu źródłowego strony. Loader ignoruje takie atrybuty z ostrzeżeniem w konsoli.
Jaki adres podłączyć
Dział zatytułowany „Jaki adres podłączyć”| Plik | Cache | Dla kogo |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minut | Typowy wybór. Otrzymujesz poprawki automatycznie. |
https://cdn.astroway.info/embed.v1.js | 1 rok, immutable | Jeśli potrzebna jest niezmienność. Aktualizowany jedynie ze względów bezpieczeństwa; zmiany zachowania pojawią się w embed.v2.js. |
Galeria widżetów
Dział zatytułowany „Galeria widżetów”Podgląd na żywo wszystkich 16 widżetów. Wybierz motyw i język treści, przełącz snippet między <iframe> a loaderem <script> i skopiuj gotowy kod.
Wspólne parametry
Dział zatytułowany „Wspólne parametry”Akceptują wszystkie widżety:
| Parametr | Wartość | Domyślnie | Opis |
|---|---|---|---|
theme | dark · light · console | dark | Schemat kolorów. |
lang | uk · en · +18 języków | uk | Język treści. Czytany także z nagłówka Accept-Language. |
disclaimer | 1 · true · yes | wyłączone | Dodaje w stopce zastrzeżenie o rozrywkowo‑informacyjnym charakterze treści (nie jest poradą medyczną, psychologiczną, finansową ani prawną). |
Widżety
Dział zatytułowany „Widżety”| Widżet | Endpoint | Specyficzne parametry |
|---|---|---|
| Horoskop dnia | GET /embed/daily-horoscope | sign, date |
| Koło natalne | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Taśma tranzytów | GET /embed/transit-timeline | date, days (max. 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Wedyjski kundli | GET /embed/kundli | date, time, lat, lng, tz |
| Mini‑mapa | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planeta dnia | GET /embed/planet-of-day | date |
| Faza Księżyca | GET /embed/moon-phase | date |
| Tarot dnia | GET /embed/daily-tarot | date |
| Miesięczna prognoza | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Tranzyty nieba | GET /embed/transit | date |
| Numerologia | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (współrzędne obowiązkowe) |
| Synastry | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Kalendarz księżycowy | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Rozkład tarota | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formaty: data - YYYY-MM-DD, czas - HH:MM, tz - przesunięcie od UTC w godzinach. Nie podane parametry są uzupełniane inteligentnym domyślnym (bieżąca data, południe, równik).