Widgets astrológicos para o site
Os widgets HTML públicos GET /v1/embed/* devolvem um fragmento iframe pronto - roda SVG, horóscopo, numerologia, etc. Sem chave de API, limite por IP do visitante (120 pedidos por hora, separado de /v1/public/*, pelo que uma página com vários widgets não esgota o limite), cache public, max-age=300. Adequados para páginas de marketing; para produção com tráfego elevado, usa o 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 onde começar
Seção intitulada “Por onde começar”A forma de incorporação depende da plataforma do teu site. O conteúdo é o mesmo, a diferença está apenas em quanto trabalho te sobra.
| Site | O que instalar |
|---|---|
| WordPress | Plugin AstroWay: 18 shortcodes e 26 blocos Gutenberg. Onze widgets funcionam logo após a instalação, sem chave. |
| WordPress com Elementor | AstroWay for Elementor: sete widgets diretamente no editor, por arrastar e largar. |
| Tilda, Squarespace, Wix, HTML simples | O script loader abaixo ou um <iframe> pronto da galeria. Copia-se com um botão. |
| Frontend próprio | Os mesmos endpoints /v1/embed/*, ou o SDK, se precisares de controlo total sobre o layout. |
Os plugins devolvem o mesmo conteúdo que os endpoints desta página, mas renderizam-no no estilo do teu tema e não exigem ajuste manual da altura.
Um widget à parte: calculadora de mapa natal
Seção intitulada “Um widget à parte: calculadora de mapa natal”Os widgets desta página desenham o que já sabes: a data, a hora e o local são fornecidos por ti. Se precisares que seja o próprio visitante a introduzir os dados, existe outro widget nosso, a calculadora de mapa natal (pacote @astroway/widget). É um formulário, cálculo e roda numa única incorporação, dez idiomas, temas claro e escuro.
A diferença não está no aspeto, mas em onde ocorre o cálculo. A calculadora calcula no navegador do visitante, e os dados de nascimento nunca chegam ao servidor. Os widgets /v1/embed/* são calculados por nós, por isso os seus parâmetros são visíveis no endereço do iframe.
| O que precisas | O que escolher |
|---|---|
| O visitante introduz os seus próprios dados de nascimento | Calculadora @astroway/widget |
| Os dados de nascimento não devem sair do navegador | Calculadora @astroway/widget |
| Horóscopo, trânsitos, tarot, numerologia, panchang e mais doze tipos | Os widgets desta página |
| Vinte idiomas em vez de dez | Os widgets desta página |
Script loader
Seção intitulada “Script loader”Se não quiseres calcular tu mesmo a altura do iframe, inclui o loader: ele insere o iframe no seu próprio lugar e ajusta automaticamente a altura ao conteúdo, porque o widget comunica o seu tamanho 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>Qualquer atributo data-* torna-se um parâmetro de query, pelo que data-theme="light" e data-lang="en" funcionam tal como no exemplo com iframe. data-height="500" fixa a altura e desativa o ajuste automático. Vários widgets na mesma página não interferem uns com os outros.
A chave não é necessária nem aceite. Os endpoints /v1/embed/* são públicos, e uma chave num atributo acabaria no código-fonte da página. O loader ignora esses atributos com um aviso na consola.
Que endereço incluir
Seção intitulada “Que endereço incluir”| Ficheiro | Cache | Para quem |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 minutos | Escolha padrão. Recebes correções automaticamente. |
https://cdn.astroway.info/embed.v1.js | 1 ano, immutable | Se precisares de imutabilidade. Atualizado apenas por segurança; mudanças de comportamento irão para embed.v2.js. |
Galeria de widgets
Seção intitulada “Galeria de widgets”Pré-visualização ao vivo dos 16 widgets. Escolhe o tema e o idioma do conteúdo, alterna o snippet entre <iframe> e o loader <script> e copia o código pronto.
Parâmetros comuns
Seção intitulada “Parâmetros comuns”Aceites por todos os widgets:
| Parâmetro | Valores | Predefinição | Descrição |
|---|---|---|---|
theme | dark · light · console | dark | Esquema de cores. |
lang | uk · en · +18 idiomas | uk | Idioma do conteúdo. Também é lido do header Accept-Language. |
disclaimer | 1 · true · yes | desativado | Adiciona no rodapé uma ressalva sobre o caráter recreativo e informativo do conteúdo (não é aconselhamento médico, psicológico, financeiro ou jurídico). |
Widgets
Seção intitulada “Widgets”| Widget | Endpoint | Parâmetros específicos |
|---|---|---|
| Horóscopo do dia | GET /embed/daily-horoscope | sign, date |
| Roda natal | GET /embed/wheel (alias /embed/natal) | date, time, lat, lng, tz, city |
| Linha temporal 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-mapa | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Planeta do dia | GET /embed/planet-of-day | date |
| Fase da Lua | GET /embed/moon-phase | date |
| Tarot do dia | GET /embed/daily-tarot | date |
| Previsão mensal | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Trânsitos do céu | GET /embed/transit | date |
| Numerologia | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (coordenadas obrigatórias) |
| Sinastria | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Calendário lunar | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Tiragem de tarot | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Formatos: data - YYYY-MM-DD, hora - HH:MM, tz - deslocamento em relação a UTC em horas. Os parâmetros não definidos são preenchidos com valores predefinidos sensatos (data atual, meio-dia, equador).