Widgets astrologiques pour le site
Les widgets HTML publics GET /v1/embed/* renvoient un fragment iframe prêt à l’emploi – roue SVG, horoscope, numérologie, etc. Sans clé API, limite par IP du visiteur (120 requêtes par heure, séparée de /v1/public/*, donc une page avec plusieurs widgets ne touche pas la limite), cache public, max-age=300. Convient aux pages marketing ; pour une production à fort trafic utilise le 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>Par où commencer
Section intitulée « Par où commencer »La façon d’insérer dépend de la plateforme sur laquelle ton site est construit. Le contenu est identique, la différence réside seulement dans la quantité de travail qui te reste.
| Site | À placer |
|---|---|
| WordPress | Plugin AstroWay : 18 shortcodes et 26 blocs Gutenberg. Onze widgets fonctionnent immédiatement après l’installation, sans clé. |
| WordPress avec Elementor | AstroWay for Elementor : sept widgets directement dans l’éditeur, par glisser‑déposer. |
| Tilda, Squarespace, Wix, HTML classique | Le script chargeur ci‑dessous ou un <iframe> prêt depuis la galerie. Copié en un clic. |
| Frontend personnalisé | Les mêmes endpoints /v1/embed/*, ou le SDK si tu as besoin d’un contrôle total sur le markup. |
Les plugins renvoient le même contenu que les endpoints sur cette page, mais l’affichent avec le style de ton thème et n’ont pas besoin d’ajuster manuellement la hauteur.
Widget individuel : calculateur de carte natale
Section intitulée « Widget individuel : calculateur de carte natale »Les widgets sur cette page affichent ce que tu connais déjà : la date, l’heure et le lieu que tu fournis. Si tu veux que les données soient saisies par le visiteur, il existe un autre de nos widgets, le calculateur de carte natale (package @astroway/widget). C’est un formulaire, le calcul et la roue en une seule insertion, dix langues, thèmes clair et sombre.
La différence n’est pas dans le rendu, mais dans l’endroit où le calcul est effectué. Le calculateur calcule dans le navigateur du visiteur, et les données de naissance ne sont jamais envoyées au serveur. Les widgets /v1/embed/* sont calculés par nous, donc leurs paramètres apparaissent dans l’URL de l’iframe.
| Ce dont tu as besoin | Que prendre |
|---|---|
| Le visiteur saisit ses propres données de naissance | Calculateur @astroway/widget |
| Les données de naissance ne doivent pas quitter le navigateur | Calculateur @astroway/widget |
| Horoscope, transits, tarot, numérologie, panchang et douze autres types | Widgets sur cette page |
| Vingt langues au lieu de dix | Widgets sur cette page |
Script chargeur
Section intitulée « Script chargeur »Si tu ne veux pas calculer toi‑même la hauteur de l’iframe, intègre le chargeur : il insère l’iframe à sa place et ajuste automatiquement la hauteur au contenu, car le widget communique sa taille via 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>Tout attribut data-* devient un paramètre de requête, ainsi data-theme="light" et data-lang="en" fonctionnent de la même façon que dans l’exemple avec l’iframe. data-height="500" fixe la hauteur et désactive l’ajustement automatique. Plusieurs widgets sur la même page ne se gênent pas entre eux.
Aucune clé n’est requise ni acceptée. Les endpoints /v1/embed/* sont publics, et une clé dans un attribut apparaîtrait dans le code source de la page. Le chargeur ignore ces attributs avec un avertissement dans la console.
Quelle URL connecter
Section intitulée « Quelle URL connecter »| Fichier | Cache | À qui |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minutes | Choix par défaut. Tu reçois les correctifs automatiquement. |
https://cdn.astroway.info/embed.v1.js | 1 an, immutable | Si tu as besoin d’immuabilité. Mis à jour uniquement pour des raisons de sécurité ; les changements de comportement arriveront dans embed.v2.js. |
Galerie des widgets
Section intitulée « Galerie des widgets »Aperçu en direct des 16 widgets. Choisis le thème et la langue du contenu, bascule le snippet entre <iframe> et le chargeur <script> et copie le code prêt à l’emploi.
Paramètres communs
Section intitulée « Paramètres communs »Tous les widgets acceptent :
| Paramètre | Valeur | Par défaut | Description |
|---|---|---|---|
theme | dark · light · console | dark | Schéma de couleur. |
lang | uk · en · +18 langues | uk | Langue du contenu. Aussi lu depuis l’en‑tête Accept-Language. |
disclaimer | 1 · true · yes | désactivé | Ajoute dans le pied de page une mention indiquant le caractère ludique et informatif du contenu (pas de conseil médical, psychologique, financier ou juridique). |
| Widget | Endpoint | Paramètres spécifiques |
|---|---|---|
| Horoscope du jour | GET /embed/daily-horoscope | sign, date |
| Roue natale | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Chronologie des transits | GET /embed/transit-timeline | date, days (max 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Kundli védique | GET /embed/kundli | date, time, lat, lng, tz |
| Mini‑carte | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planète du jour | GET /embed/planet-of-day | date |
| Phase de la Lune | GET /embed/moon-phase | date |
| Tarot du jour | GET /embed/daily-tarot | date |
| Prévision mensuelle | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Transits du ciel | GET /embed/transit | date |
| Numérologie | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (coordonnées obligatoires) |
| Synastrie | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Calendrier lunaire | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Disposition de tarot | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formats : date - YYYY-MM-DD, heure - HH:MM, tz - décalage par rapport à UTC en heures. Les paramètres non fournis sont remplacés par des valeurs par défaut intelligentes (date actuelle, midi, équateur).