Widgeturi astrologice pentru site
Widgeturile HTML publice GET /v1/embed/* returnează un fragment iframe gata de utilizare - roată SVG, horoscop, numerologie etc. Fără cheie API, limită pe IP-ul vizitatorului (120 de cereri pe oră, separat de /v1/public/*, deci o pagină cu mai multe widgeturi nu atinge limita), cache public, max-age=300. Sunt potrivite pentru pagini de marketing; pentru producție cu trafic mare folosește 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>De unde să începi
Section titled “De unde să începi”Metoda de inserare depinde de platforma pe care e construit site-ul tău. Conținutul e același, diferă doar câtă muncă îți rămâne ție.
| Site | Ce să folosești |
|---|---|
| WordPress | Pluginul AstroWay: 18 shortcode-uri și 26 de blocuri Gutenberg. Unsprezece widgeturi funcționează imediat după instalare, fără cheie. |
| WordPress cu Elementor | AstroWay for Elementor: șapte widgeturi direct în editor, prin drag-and-drop. |
| Tilda, Squarespace, Wix, HTML simplu | Scriptul loader de mai jos sau un <iframe> gata făcut din galerie. Se copiază cu un singur buton. |
| Frontend propriu | Aceleași endpointuri /v1/embed/*, sau SDK, dacă ai nevoie de control total asupra layout-ului. |
Pluginurile returnează același conținut ca endpointurile de pe această pagină, dar îl afișează în stilul temei tale și nu necesită ajustarea manuală a înălțimii.
Un widget separat: calculatorul de hartă natală
Section titled “Un widget separat: calculatorul de hartă natală”Widgeturile de pe această pagină afișează ceea ce știi deja: data, ora și locul le transmiți tu. Dacă vrei ca datele să fie introduse de vizitator, există un alt widget al nostru, calculatorul de hartă natală (pachetul @astroway/widget). Este un formular, calcul și roată într-o singură inserare, zece limbi, teme luminoasă și întunecată.
Diferența nu e în aspect, ci în locul unde se face calculul. Calculatorul calculează în browserul vizitatorului, iar datele de naștere nu ajung deloc pe server. Widgeturile /v1/embed/* sunt calculate de noi, de aceea parametrii lor sunt vizibili în adresa iframe-ului.
| Ce îți trebuie | Ce să alegi |
|---|---|
| Vizitatorul își introduce propriile date de naștere | Calculatorul @astroway/widget |
| Datele de naștere nu trebuie să părăsească browserul | Calculatorul @astroway/widget |
| Horoscop, tranzite, tarot, numerologie, panchang și încă douăsprezece tipuri | Widgeturile de pe această pagină |
| Douăzeci de limbi în loc de zece | Widgeturile de pe această pagină |
Scriptul loader
Section titled “Scriptul loader”Dacă nu vrei să calculezi singur înălțimea iframe-ului, conectează loaderul: acesta inserează iframe-ul în locul său și ajustează automat înălțimea în funcție de conținut, deoarece widgetul își comunică dimensiunea prin 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>Orice atribut data-* devine parametru de cerere, deci data-theme="light" și data-lang="en" funcționează la fel ca în exemplul cu iframe. data-height="500" fixează înălțimea și dezactivează ajustarea automată. Mai multe widgeturi pe aceeași pagină nu interferează între ele.
Cheia nu este necesară și nu este acceptată. Endpointurile /v1/embed/* sunt publice, iar o cheie într-un atribut ar ajunge în codul sursă al paginii. Loaderul ignoră astfel de atribute cu un avertisment în consolă.
Ce adresă să conectezi
Section titled “Ce adresă să conectezi”| Fișier | Cache | Pentru cine |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minute | Alegerea implicită. Primești corecturile automat. |
https://cdn.astroway.info/embed.v1.js | 1 an, immutable | Dacă ai nevoie de imuabilitate. Se actualizează doar din motive de securitate; schimbările de comportament vor ajunge în embed.v2.js. |
Galeria de widgeturi
Section titled “Galeria de widgeturi”Previzualizare live a tuturor celor 16 widgeturi. Alege tema și limba conținutului, comută snippet-ul între <iframe> și loaderul <script> și copiază codul gata făcut.
Parametri comuni
Section titled “Parametri comuni”Acceptați de toate widgeturile:
| Parametru | Valori | Implicit | Descriere |
|---|---|---|---|
theme | dark · light · console | dark | Schema de culori. |
lang | uk · en · +18 limbi | uk | Limba conținutului. Se citește și din headerul Accept-Language. |
disclaimer | 1 · true · yes | dezactivat | Adaugă în footer o mențiune despre caracterul recreativ-informativ al conținutului (nu este consultanță medicală, psihologică, financiară sau juridică). |
Widgeturi
Section titled “Widgeturi”| Widget | Endpoint | Parametri specifici |
|---|---|---|
| Horoscopul zilei | GET /embed/daily-horoscope | sign, date |
| Roata natală | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Cronologia tranzitelor | GET /embed/transit-timeline | date, days (max. 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Kundli vedică | GET /embed/kundli | date, time, lat, lng, tz |
| Mini-hartă | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planeta zilei | GET /embed/planet-of-day | date |
| Faza Lunii | GET /embed/moon-phase | date |
| Tarotul zilei | GET /embed/daily-tarot | date |
| Prognoza lunară | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Tranzitele cerului | GET /embed/transit | date |
| Numerologie | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (coordonatele sunt obligatorii) |
| Sinastrie | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Calendar lunar | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Etalare tarot | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formate: data - YYYY-MM-DD, ora - HH:MM, tz - decalajul față de UTC în ore. Parametrii nespecificati sunt completați cu valori implicite inteligente (data curentă, amiază, ecuator).