Construtores de sites
Construtor de sites mostra a sua página no navegador do visitante, portanto a regra é oposta às instruções para automações: tu inseres o widget, e não a chave. Ambos os snippets abaixo foram carregados a partir de uma página em um domínio externo no Chrome 2026-09-17, e ambos foram renderizados.
Inserir um dos snippets
Seção intitulada “Inserir um dos snippets”Iframe comum, quando o tamanho é conhecido:
<iframe src="https://api.astroway.info/v1/embed/moon-phase?theme=light&lang=uk" width="320" height="360" style="border:0"></iframe>Carregador, quando não quiser ajustar o tamanho: ele substitui-se por um iframe e ajusta a altura ao conteúdo através de postMessage.
<script src="https://cdn.astroway.info/embed.js" data-widget="moon-phase" data-lang="uk" data-theme="light"></script>Quinze widgets, todos os parâmetros e um botão de cópia para cada um na página Widgets. Qualquer atributo data-* torna-se um parâmetro de pedido.
Onde inserir o código
Seção intitulada “Onde inserir o código”| Construtor | O que procurar |
|---|---|
| Wix | elemento de inserção de código HTML |
| Squarespace | bloco de código |
| Shopify | secção custom liquid ou editor de código do tema |
| Webflow | elemento embed |
| Tilda | bloco de código HTML, T123 |
Para Wix e Squarespace os links levam à sua documentação; os outros três são nomeados pela função, pois as suas páginas de documentação não são abertas automaticamente na verificação, e não vamos linkar para algo não verificado.
Chave não necessária e não aceita
Seção intitulada “Chave não necessária e não aceita”Os endpoints /v1/embed/* são públicos. A chave no atributo da página seria vista por cada visitante, portanto o carregador a ignora e escreve sobre isso no console.
Limites: 30 pedidos por hora por IP do visitante, as respostas são cacheadas durante cinco minutos. Assim, uma página com muitos visitantes sente-se bem, enquanto um único visitante que a recarrega em loop não.
O que a página não pode chamar
Seção intitulada “O que a página não pode chamar”O navegador em um domínio diferente responde apenas a /v1/public/* e /v1/embed/*. Tudo o resto sob /v1/* é rejeitado no preflight: a partir de uma página em um domínio externo, POST /v1/chart retornou sem o cabeçalho access-control-allow-origin, e o Chrome o bloqueou, enquanto POST /v1/public/chart a partir da mesma página respondeu com 200.
Portanto, se quiser que o visitante insira os próprios dados de nascimento e veja o mapa, utiliza os endpoints sem chave ou [o widget calculadora de mapa natal](/products/embed-widgets/#окремий-віджет-калькулятор-натальної карти), que calcula diretamente no navegador. Tudo o que requer uma chave secreta vive no servidor: o seu próprio ou numa das ferramentas da secção Integrações sem código.