# Weboldalkészítők

A weboldalkészítő a látogató böngészőjében mutatja az oldaladat, ezért a szabály ellentétes az automatizálási útmutatókkal: te widgetet illesztesz be, nem kulcsot. Az alábbi két snippet-et egy külső domainen lévő oldalról töltötték be a Chrome 2026-09-17‑ben, és mindkettő megjelenik.

## Illessz be egyet a snippet‑ek közül

Általános iframe, ha a méret ismert:

```html
<iframe src="https://api.astroway.info/v1/embed/moon-phase?theme=light&lang=uk"
        width="320" height="360" style="border:0"></iframe>
```

Loader, ha nem akarod a méretet kiválasztani: lecseréli magát egy iframe‑re és a magasságot a tartalomhoz igazítja a `postMessage` segítségével.

```html
<script src="https://cdn.astroway.info/embed.js"
        data-widget="moon-phase" data-lang="uk" data-theme="light"></script>
```

Tizenöt widget, minden paraméter és egy másolás gomb mindenhez az [Widgetek](/products/embed-widgets/) oldalon. Bármely `data-*` attribútum lekérdezési paraméterré válik.

## Hol illeszd be a kódot

| Építő | Mit keress |
|---|---|
| Wix | [HTML kód beillesztő elem](https://support.wix.com/en/article/wix-editor-embedding-a-site-or-a-widget) |
| Squarespace | [kód blokk](https://support.squarespace.com/hc/en-us/articles/205815908-Code-blocks) |
| Shopify | custom liquid szekció vagy téma kódszerkesztő |
| Webflow | embed elem |
| Tilda | HTML kód blokk, T123 |

A Wix és Squarespace esetén a linkek a saját súgóikra mutatnak; a többi hármat a funkció neve alapján neveztem, mivel a súgóoldalaik nem nyílnak meg automatikus ellenőrzéssel, és nem fogunk hivatkozni ellenőrizetlen forrásra.

## A kulcs nem szükséges és nem fogadott el

A `/v1/embed/*` végpontok nyilvánosak. A kulcs a oldal attribútumában minden látogató látná, ezért a loader figyelmen kívül hagyja és a konzolba ír róla.

Limit: **30 kérés óránként a látogató IP‑címéről**, a válaszok öt percre vannak cache‑elve. Így egy sok látogatót vonzó oldal jól működik, de egyetlen látogató, aki folyamatosan újratölti, nem.

## Mit nem tud meghívni az oldal

A böngészőnek egy külső domainen csak a `/v1/public/*` és a `/v1/embed/*` válaszol. Minden más a `/v1/*` alatt preflight‑ot utasít el: egy külső domainről érkező `POST /v1/chart` válaszolt `access-control-allow-origin` fejléc nélkül, és a Chrome blokkolta, míg a `POST /v1/public/chart` ugyanarról az oldalról `200`‑as választ adott.

Tehát ha azt szeretnéd, hogy a látogató saját születési adatait adja meg és lássa a térképet, használd a [kulcs nélküli végpontokat](/free/) vagy a [születési horoszkóp kalkulátor widgetet](/products/embed-widgets/#окремий-віджет-калькулятор-натальної-карти), amely egyszerűen a böngészőben számol. Minden, ami titkos kulcsot igényel, a szerveren fut: a sajátodon vagy a [Kód nélküli integrációk](/integrations/) szekció egyik eszközében.

<Aside type="note" title="Mikor lesz hasznos a nyilvános kulcs">
A `pk_` kulcsot érdemes létrehozni, ha az oldal saját magát hívja meg a `/v1/public/*` végpontokra és a közös látogatói limit nem elég: a fizetett csomagban a kulcs saját limitet kap, és az origin lista miatt más domainen értelmetlen. A fenti widgetekhez egyáltalán nincs rá szükség.
</Aside>