Astrologische widgets voor de website

De publieke HTML-widgets GET /v1/embed/* leveren een kant-en-klaar iframe-fragment: een SVG-wiel, horoscoop, numerologie enzovoort. Zonder API-sleutel, limiet per IP van de bezoeker (120 verzoeken per uur, apart van /v1/public/*, dus een pagina met meerdere widgets botst niet tegen de limiet), cache public, max-age=300. Geschikt voor marketingpagina’s; gebruik voor high-traffic productie de 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>

Waar te beginnen

De manier van insluiten hangt af van waar je site op is gebouwd. De inhoud is hetzelfde, het verschil zit alleen in hoeveel werk er voor jou overblijft.

Site	Wat te gebruiken
WordPress	De plugin AstroWay: 18 shortcodes en 26 Gutenberg-blokken. Elf widgets werken direct na installatie, zonder sleutel.
WordPress met Elementor	AstroWay for Elementor: zeven widgets direct in de editor, via slepen en neerzetten.
Tilda, Squarespace, Wix, gewone HTML	De script-loader hieronder of een kant-en-klare `<iframe>` uit de galerij. Met één knop te kopiëren.
Eigen frontend	Dezelfde endpoints `/v1/embed/*`, of de SDK als je volledige controle over de opmaak wilt.

De plugins leveren dezelfde inhoud als de endpoints op deze pagina, maar tekenen die in de stijl van je thema en vereisen geen handmatig afstellen van de hoogte.

De widgets op deze pagina tekenen wat jij al weet: datum, tijd en plaats geef jij door. Als je wilt dat de bezoeker zelf de gegevens invoert, is er een andere widget van ons, de calculator voor geboortekaarten (pakket @astroway/widget). Dat is een formulier, berekening en wiel in één insluiting, tien talen, lichte en donkere thema’s.

Het verschil zit niet in de vormgeving, maar in waar de berekening plaatsvindt. De calculator rekent in de browser van de bezoeker, en de geboortegegevens gaan helemaal niet naar de server. De widgets /v1/embed/* berekenen wij, dus hun parameters zijn zichtbaar in het adres van de iframe.

Wat je nodig hebt	Wat je kiest
Bezoeker voert eigen geboortegegevens in	Calculator `@astroway/widget`
Geboortegegevens mogen de browser niet verlaten	Calculator `@astroway/widget`
Horoscoop, transits, tarot, numerologie, panchang en nog twaalf andere typen	Widgets op deze pagina
Twintig talen in plaats van tien	Widgets op deze pagina

Script-loader

Als je niet zelf de hoogte van de iframe wilt berekenen, sluit dan de loader in: die plaatst een iframe op zijn eigen plek en past de hoogte automatisch aan aan de inhoud, omdat de widget zijn afmetingen via postMessage doorgeeft.

<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>

Elk data-*-attribuut wordt een queryparameter, dus data-theme="light" en data-lang="en" werken hetzelfde als in het iframe-voorbeeld. data-height="500" zet de hoogte vast en schakelt de automatische aanpassing uit. Meerdere widgets op één pagina storen elkaar niet.

Een sleutel is niet nodig en wordt niet geaccepteerd. De endpoints /v1/embed/* zijn publiek, en een sleutel in een attribuut zou in de broncode van de pagina terechtkomen. De loader negeert zulke attributen met een waarschuwing in de console.

Welk adres insluiten

Bestand	Cache	Voor wie
`https://cdn.astroway.info/embed.js`	5 minuten	De standaardkeuze. Je krijgt fixes automatisch.
`https://cdn.astroway.info/embed.v1.js`	1 jaar, immutable	Als je onveranderlijkheid nodig hebt. Wordt alleen bijgewerkt voor beveiliging; gedragswijzigingen komen in `embed.v2.js`.

Widgetgalerij

Live voorbeeld van alle 16 widgets. Kies het thema en de taal van de inhoud, schakel het snippet tussen <iframe> en de <script>-loader en kopieer de kant-en-klare code.

Gemeenschappelijke parameters

Geaccepteerd door alle widgets:

Parameter	Waarden	Standaard	Beschrijving
`theme`	`dark` · `light` · `console`	`dark`	Kleurenschema.
`lang`	`uk` · `en` · +18 talen	`uk`	Taal van de inhoud. Wordt ook uit de header `Accept-Language` gelezen.
`disclaimer`	`1` · `true` · `yes`	uit	Voegt in de footer een disclaimer toe over het recreatief-informatieve karakter van de inhoud (geen medisch, psychologisch, financieel of juridisch advies).

Widgets

Widget	Endpoint	Specifieke parameters
Daghoroscoop	`GET /embed/daily-horoscope`	`sign`, `date`
Geboortewiel	`GET /embed/wheel` (alias `/embed/natal`)	`date`, `time`, `lat`, `lng`, `tz`, `city`
Transittijdlijn	`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`
Minikaart	`GET /embed/mini-chart`	`date`, `time`, `lat`, `lng`, `tz`, `city`
Planeet van de dag	`GET /embed/planet-of-day`	`date`
Maanfase	`GET /embed/moon-phase`	`date`
Tarot van de dag	`GET /embed/daily-tarot`	`date`
Maandvoorspelling	`GET /embed/monthly-forecast`	`sign`, `month` (`YYYY-MM`)
Hemeltransits	`GET /embed/transit`	`date`
Numerologie	`GET /embed/numerology`	`name`, `date`, `system` (`pythagorean` · `chaldean`)
Panchang	`GET /embed/panchang`	`date`, `lat`, `lng`, `tz` (coördinaten verplicht)
Synastrie	`GET /embed/synastry`	`date_a`, `time_a`, `lat_a`, `lng_a`, `tz_a`, `date_b`, `time_b`, `lat_b`, `lng_b`, `tz_b`
Maankalender	`GET /embed/moon-calendar`	`month` (`YYYY-MM`), `tz`
Tarotlegging	`GET /embed/tarot-spread`	`spread` (`single-card` · `three-card` · `decision` · `career`), `date`, `seed`, `reversed`, `art`

Formaten: datum - YYYY-MM-DD, tijd - HH:MM, tz - verschuiving ten opzichte van UTC in uren. Niet-opgegeven parameters worden ingevuld met een slimme standaardwaarde (huidige datum, middag, evenaar).

Nuttig?

Wijziging voorstellen

Laatst bewerkt: 9 okt 2026