Astrologische Widgets für die Website
Die öffentlichen HTML-Widgets GET /v1/embed/* liefern ein fertiges iframe-Fragment – SVG-Rad, Horoskop, Numerologie usw. Ohne API-Key, Limit pro Besucher-IP (120 Anfragen pro Stunde, getrennt von /v1/public/*, sodass eine Seite mit mehreren Widgets nicht ans Limit stößt), Cache public, max-age=300. Geeignet für Marketing-Seiten; für High-Traffic-Produktion nutze das 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>Womit du anfängst
Abschnitt betitelt „Womit du anfängst“Die Einbindungsmethode hängt davon ab, womit deine Website gebaut ist. Der Inhalt ist derselbe, der Unterschied liegt nur darin, wie viel Arbeit bei dir bleibt.
| Website | Was du einsetzt |
|---|---|
| WordPress | Das Plugin AstroWay: 18 Shortcodes und 26 Gutenberg-Blöcke. Elf Widgets funktionieren sofort nach der Installation, ohne Key. |
| WordPress mit Elementor | AstroWay for Elementor: sieben Widgets direkt im Editor, per Drag & Drop. |
| Tilda, Squarespace, Wix, einfaches HTML | Der Script-Loader unten oder ein fertiges <iframe> aus der Galerie. Mit einem Klick kopierbar. |
| Eigenes Frontend | Dieselben Endpunkte /v1/embed/* oder das SDK, wenn du volle Kontrolle über das Markup brauchst. |
Die Plugins liefern denselben Inhalt wie die Endpunkte auf dieser Seite, rendern ihn aber im Design deines Themes und erfordern kein manuelles Anpassen der Höhe.
Einzelnes Widget: Geburtshoroskop-Rechner
Abschnitt betitelt „Einzelnes Widget: Geburtshoroskop-Rechner“Die Widgets auf dieser Seite zeichnen das, was du bereits kennst: Datum, Uhrzeit und Ort übergibst du. Wenn die Daten vom Besucher selbst eingegeben werden sollen, gibt es ein anderes Widget von uns, den Geburtshoroskop-Rechner (Paket @astroway/widget). Das ist Formular, Berechnung und Rad in einer Einbindung, zehn Sprachen, helles und dunkles Theme.
Der Unterschied liegt nicht im Design, sondern darin, wo die Berechnung stattfindet. Der Rechner rechnet im Browser des Besuchers, und die Geburtsdaten gehen überhaupt nicht an den Server. Die Widgets /v1/embed/* berechnen wir, daher sind ihre Parameter in der iframe-Adresse sichtbar.
| Was du brauchst | Was du nimmst |
|---|---|
| Der Besucher gibt eigene Geburtsdaten ein | Rechner @astroway/widget |
| Geburtsdaten dürfen den Browser nicht verlassen | Rechner @astroway/widget |
| Horoskop, Transite, Tarot, Numerologie, Panchang und zwölf weitere Typen | Widgets auf dieser Seite |
| Zwanzig Sprachen statt zehn | Widgets auf dieser Seite |
Script-Loader
Abschnitt betitelt „Script-Loader“Wenn du die iframe-Höhe nicht selbst berechnen willst, binde den Loader ein: Er fügt das iframe an seiner Stelle ein und passt die Höhe automatisch an den Inhalt an, weil das Widget seine Größe per postMessage mitteilt.
<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>Jedes data-*-Attribut wird zu einem Query-Parameter, sodass data-theme="light" und data-lang="en" genauso funktionieren wie im iframe-Beispiel. data-height="500" fixiert die Höhe und deaktiviert die automatische Anpassung. Mehrere Widgets auf einer Seite stören sich nicht gegenseitig.
Ein Key ist nicht nötig und wird nicht akzeptiert. Die Endpunkte /v1/embed/* sind öffentlich, und ein Key im Attribut würde im Quellcode der Seite landen. Der Loader ignoriert solche Attribute mit einer Warnung in der Konsole.
Welche Adresse du einbindest
Abschnitt betitelt „Welche Adresse du einbindest“| Datei | Cache | Für wen |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 Minuten | Standardwahl. Du erhältst Fixes automatisch. |
https://cdn.astroway.info/embed.v1.js | 1 Jahr, immutable | Wenn du Unveränderlichkeit brauchst. Wird nur aus Sicherheitsgründen aktualisiert; Verhaltensänderungen gehen in embed.v2.js. |
Widget-Galerie
Abschnitt betitelt „Widget-Galerie“Live-Vorschau aller 16 Widgets. Wähle Theme und Inhaltssprache, schalte das Snippet zwischen <iframe> und <script>-Loader um und kopiere den fertigen Code.
Gemeinsame Parameter
Abschnitt betitelt „Gemeinsame Parameter“Werden von allen Widgets akzeptiert:
| Parameter | Werte | Standard | Beschreibung |
|---|---|---|---|
theme | dark · light · console | dark | Farbschema. |
lang | uk · en · +18 Sprachen | uk | Inhaltssprache. Wird auch aus dem Header Accept-Language gelesen. |
disclaimer | 1 · true · yes | aus | Fügt im Footer einen Hinweis auf den Unterhaltungs- und Informationscharakter des Inhalts hinzu (keine medizinische, psychologische, finanzielle oder rechtliche Beratung). |
Widgets
Abschnitt betitelt „Widgets“| Widget | Endpoint | Spezifische Parameter |
|---|---|---|
| Tageshoroskop | GET /embed/daily-horoscope | sign, date |
| Geburtshoroskop-Rad | GET /embed/wheel (Alias /embed/natal) | date, time, lat, lng, tz, city |
| Transit-Timeline | GET /embed/transit-timeline | date, days (max. 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Vedische Kundli | GET /embed/kundli | date, time, lat, lng, tz |
| Mini-Chart | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planet des Tages | GET /embed/planet-of-day | date |
| Mondphase | GET /embed/moon-phase | date |
| Tarot des Tages | GET /embed/daily-tarot | date |
| Monatsprognose | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Himmelstransite | GET /embed/transit | date |
| Numerologie | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (Koordinaten erforderlich) |
| Synastrie | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Mondkalender | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Tarot-Legung | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formate: Datum – YYYY-MM-DD, Uhrzeit – HH:MM, tz – Versatz von UTC in Stunden. Nicht angegebene Parameter werden mit sinnvollen Defaults ergänzt (aktuelles Datum, Mittag, Äquator).