Widgets astrológicos para el sitio

Los widgets HTML públicos GET /v1/embed/* devuelven un fragmento iframe listo para usar: rueda SVG, horóscopo, numerología, etc. Sin clave de API, límite por IP del visitante (120 solicitudes por hora, independiente de /v1/public/*, así que una página con varios widgets no agota el límite), caché public, max-age=300. Adecuados para páginas de marketing; para producción de alto tráfico usa el 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>

Por dónde empezar

La forma de inserción depende de la plataforma de tu sitio. El contenido es el mismo, la diferencia está solo en cuánto trabajo te queda a ti.

Sitio	Qué usar
WordPress	El plugin AstroWay: 18 shortcodes y 26 bloques de Gutenberg. Once widgets funcionan nada más instalarlo, sin clave.
WordPress con Elementor	AstroWay for Elementor: siete widgets directamente en el editor, arrastrando y soltando.
Tilda, Squarespace, Wix, HTML plano	El script loader de abajo o un `<iframe>` listo de la galería. Se copia con un botón.
Frontend propio	Los mismos endpoints `/v1/embed/*`, o el SDK si necesitas control total sobre el maquetado.

Los plugins sirven el mismo contenido que los endpoints de esta página, pero lo dibujan con el estilo de tu tema y no requieren ajustar la altura manualmente.

Los widgets de esta página dibujan lo que tú ya conoces: la fecha, la hora y el lugar los pasas tú. Si necesitas que sea el propio visitante quien introduzca los datos, existe otro widget nuestro, la calculadora de carta natal (paquete @astroway/widget). Es un formulario, el cálculo y la rueda en una sola inserción, con diez idiomas y temas claro y oscuro.

La diferencia no está en el diseño, sino en dónde ocurre el cálculo. La calculadora calcula en el navegador del visitante, y los datos de nacimiento no llegan al servidor en absoluto. Los widgets /v1/embed/* los calculamos nosotros, por eso sus parámetros son visibles en la dirección del iframe.

Qué necesitas	Qué elegir
El visitante introduce sus propios datos de nacimiento	La calculadora `@astroway/widget`
Los datos de nacimiento no deben salir del navegador	La calculadora `@astroway/widget`
Horóscopo, tránsitos, tarot, numerología, panchang y doce tipos más	Los widgets de esta página
Veinte idiomas en lugar de diez	Los widgets de esta página

Script loader

Si no quieres calcular tú mismo la altura del iframe, conecta el loader: inserta el iframe en su lugar y ajusta automáticamente la altura al contenido, porque el widget comunica su tamaño mediante 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>

Cualquier atributo data-* se convierte en un parámetro de consulta, así que data-theme="light" y data-lang="en" funcionan igual que en el ejemplo con iframe. data-height="500" fija la altura y desactiva el ajuste automático. Varios widgets en una misma página no interfieren entre sí.

No se necesita ni se acepta ninguna clave. Los endpoints /v1/embed/* son públicos, y una clave en un atributo acabaría en el código fuente de la página. El loader ignora esos atributos con una advertencia en la consola.

Qué dirección conectar

Archivo	Caché	Para quién
`https://cdn.astroway.info/embed.js`	5 minutos	La opción por defecto. Recibes las correcciones automáticamente.
`https://cdn.astroway.info/embed.v1.js`	1 año, immutable	Si necesitas inmutabilidad. Solo se actualiza por seguridad; los cambios de comportamiento irán a `embed.v2.js`.

Galería de widgets

Vista previa en vivo de los 16 widgets. Elige el tema y el idioma del contenido, cambia el snippet entre <iframe> y el cargador <script> y copia el código listo.

Parámetros comunes

Los aceptan todos los widgets:

Parámetro	Valores	Por defecto	Descripción
`theme`	`dark` · `light` · `console`	`dark`	Esquema de color.
`lang`	`uk` · `en` · +18 idiomas	`uk`	Idioma del contenido. También se lee del header `Accept-Language`.
`disclaimer`	`1` · `true` · `yes`	desactivado	Añade al pie un aviso sobre el carácter lúdico e informativo del contenido (no es asesoramiento médico, psicológico, financiero ni jurídico).

Widgets

Widget	Endpoint	Parámetros específicos
Horóscopo del día	`GET /embed/daily-horoscope`	`sign`, `date`
Rueda natal	`GET /embed/wheel` (alias `/embed/natal`)	`date`, `time`, `lat`, `lng`, `tz`, `city`
Línea de tránsitos	`GET /embed/transit-timeline`	`date`, `days` (máx. 30)
Bodygraph (Human Design)	`GET /embed/bodygraph`	`date`, `time`, `lat`, `lng`, `tz`
Kundli védica	`GET /embed/kundli`	`date`, `time`, `lat`, `lng`, `tz`
Mini-carta	`GET /embed/mini-chart`	`date`, `time`, `lat`, `lng`, `tz`, `city`
Planeta del día	`GET /embed/planet-of-day`	`date`
Fase lunar	`GET /embed/moon-phase`	`date`
Tarot del día	`GET /embed/daily-tarot`	`date`
Pronóstico mensual	`GET /embed/monthly-forecast`	`sign`, `month` (`YYYY-MM`)
Tránsitos del cielo	`GET /embed/transit`	`date`
Numerología	`GET /embed/numerology`	`name`, `date`, `system` (`pythagorean` · `chaldean`)
Panchang	`GET /embed/panchang`	`date`, `lat`, `lng`, `tz` (coordenadas obligatorias)
Sinastría	`GET /embed/synastry`	`date_a`, `time_a`, `lat_a`, `lng_a`, `tz_a`, `date_b`, `time_b`, `lat_b`, `lng_b`, `tz_b`
Calendario lunar	`GET /embed/moon-calendar`	`month` (`YYYY-MM`), `tz`
Tirada de tarot	`GET /embed/tarot-spread`	`spread` (`single-card` · `three-card` · `decision` · `career`), `date`, `seed`, `reversed`, `art`

Formatos: fecha - YYYY-MM-DD, hora - HH:MM, tz - desplazamiento respecto a UTC en horas. Los parámetros no especificados se rellenan con valores por defecto razonables (fecha actual, mediodía, ecuador).

¿Útil?

Sugerir edición

Última actualización: 9 oct 2026