Widget astrologici per il sito
I widget HTML pubblici GET /v1/embed/* restituiscono un frammento iframe pronto all’uso: ruota SVG, oroscopo, numerologia e altro. Senza API key, con limite per IP del visitatore (120 richieste all’ora, separato da /v1/public/*, quindi una pagina con più widget non raggiunge il limite), cache public, max-age=300. Sono adatti alle pagine di marketing; per un produzione ad alto traffico usa l’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>Da dove iniziare
Sezione intitolata “Da dove iniziare”Il metodo di inserimento dipende da come è fatto il tuo sito. Il contenuto è lo stesso, cambia solo quanto lavoro resta a te.
| Sito | Cosa usare |
|---|---|
| WordPress | Il plugin AstroWay: 18 shortcode e 26 blocchi Gutenberg. Undici widget funzionano subito dopo l’installazione, senza chiave. |
| WordPress con Elementor | AstroWay for Elementor: sette widget direttamente nell’editor, con trascinamento. |
| Tilda, Squarespace, Wix, HTML semplice | Lo script-loader qui sotto o un <iframe> pronto dalla galleria. Si copia con un clic. |
| Frontend personalizzato | Gli stessi endpoint /v1/embed/*, oppure l’SDK se ti serve il controllo completo sul markup. |
I plugin restituiscono lo stesso contenuto degli endpoint di questa pagina, ma lo disegnano con lo stile del tuo tema e non richiedono di regolare manualmente l’altezza.
Un widget a parte: il calcolatore di carta natale
Sezione intitolata “Un widget a parte: il calcolatore di carta natale”I widget di questa pagina disegnano ciò che già conosci: data, ora e luogo li passi tu. Se invece vuoi che sia il visitatore a inserire i dati, c’è un altro nostro widget, il calcolatore di carta natale (pacchetto @astroway/widget). È un modulo, un calcolo e una ruota in un’unica integrazione, dieci lingue, tema chiaro e scuro.
La differenza non è nell’aspetto, ma in dove avviene il calcolo. Il calcolatore calcola nel browser del visitatore, e i dati di nascita non vengono mai inviati al server. I widget /v1/embed/* li calcoliamo noi, quindi i loro parametri sono visibili nell’indirizzo dell’iframe.
| Cosa ti serve | Cosa scegliere |
|---|---|
| Il visitatore inserisce i propri dati di nascita | Il calcolatore @astroway/widget |
| I dati di nascita non devono lasciare il browser | Il calcolatore @astroway/widget |
| Oroscopo, transiti, tarocchi, numerologia, panchang e altri dodici tipi | I widget di questa pagina |
| Venti lingue invece di dieci | I widget di questa pagina |
Script-loader
Sezione intitolata “Script-loader”Se non vuoi calcolare da solo l’altezza dell’iframe, collega il loader: inserisce l’iframe al posto suo e adatta automaticamente l’altezza al contenuto, perché il widget comunica le proprie dimensioni tramite 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>Qualsiasi attributo data-* diventa un parametro della richiesta, quindi data-theme="light" e data-lang="en" funzionano esattamente come nell’esempio con l’iframe. data-height="500" fissa l’altezza e disattiva l’adattamento automatico. Più widget sulla stessa pagina non interferiscono tra loro.
La chiave non è necessaria e non viene accettata. Gli endpoint /v1/embed/* sono pubblici, e una chiave in un attributo finirebbe nel codice sorgente della pagina. Il loader ignora tali attributi con un avviso in console.
Quale indirizzo collegare
Sezione intitolata “Quale indirizzo collegare”| File | Cache | Per chi |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minuti | La scelta tipica. Ricevi le correzioni automaticamente. |
https://cdn.astroway.info/embed.v1.js | 1 anno, immutable | Se ti serve l’immutabilità. Viene aggiornato solo per motivi di sicurezza; i cambiamenti di comportamento andranno in embed.v2.js. |
Galleria dei widget
Sezione intitolata “Galleria dei widget”Anteprima live di tutti i 16 widget. Scegli il tema e la lingua del contenuto, cambia lo snippet tra <iframe> e loader <script> e copia il codice pronto.
Parametri comuni
Sezione intitolata “Parametri comuni”Accettati da tutti i widget:
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
theme | dark · light · console | dark | Schema di colori. |
lang | uk · en · +18 lingue | uk | Lingua del contenuto. Viene letta anche dall’header Accept-Language. |
disclaimer | 1 · true · yes | disattivato | Aggiunge nel footer una nota sul carattere ricreativo e informativo del contenuto (non è una consulenza medica, psicologica, finanziaria o legale). |
| Widget | Endpoint | Parametri specifici |
|---|---|---|
| Oroscopo del giorno | GET /embed/daily-horoscope | sign, date |
| Ruota natale | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Timeline dei transiti | GET /embed/transit-timeline | date, days (max 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Kundli vedica | GET /embed/kundli | date, time, lat, lng, tz |
| Mini-carta | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Pianeta del giorno | GET /embed/planet-of-day | date |
| Fase lunare | GET /embed/moon-phase | date |
| Tarocco del giorno | GET /embed/daily-tarot | date |
| Previsione mensile | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Transiti del cielo | GET /embed/transit | date |
| Numerologia | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (coordinate obbligatorie) |
| Sinastria | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Calendario lunare | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Stesa di tarocchi | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formati: data - YYYY-MM-DD, ora - HH:MM, tz - offset da UTC in ore. I parametri non specificati vengono sostituiti con un default ragionevole (data corrente, mezzogiorno, equatore).