# Web Sitesi Yapıcıları

Site oluşturucu, ziyaretçinin tarayıcısında sayfanı gösterir, bu yüzden otomasyon talimatlarının tersine bir kural var: widget'ı ekliyorsun, anahtarı değil. Aşağıdaki iki snippet, Chrome 2026-09-17'de dış bir alanda bulunan bir sayfadan yüklendi ve ikisi de render edildi.

## Bir snippet'i ekle

Boyutu bilinen normal iframe:

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

Boyutu seçmek istemediğinde loader: kendini iframe ile değiştirir ve içeriğe göre yüksekliği `postMessage` ile ayarlar.

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

On beş widget, tüm parametreler ve her biri için kopyalama düğmesi sayfada [Widget'lar](/products/embed-widgets/). Her `data-*` özniteliği istek parametresi olur.

## Kodu nereye eklemeli

| Site Oluşturucu | Ne aramalı |
|---|---|
| Wix | [HTML kod ekleme öğesi](https://support.wix.com/en/article/wix-editor-embedding-a-site-or-a-widget) |
| Squarespace | [kod bloğu](https://support.squarespace.com/hc/en-us/articles/205815908-Code-blocks) |
| Shopify | custom liquid bölümü veya tema kod editörü |
| Webflow | embed öğesi |
| Tilda | HTML kod bloğu, T123 |

Wix ve Squarespace için bağlantılar kendi belgelerine yönlendirir; geri kalan üçü fonksiyon adıyla verilmiştir, çünkü belgeleri otomatik kontrolle açılmıyor ve doğrulanmamış bir şeye bağlanmayacağız.

## Anahtar gerekli değil ve kabul edilmiyor

`/v1/embed/*` endpoint'leri herkese açık. Sayfa özniteliğindeki anahtarı her ziyaretçi görür, bu yüzden loader onu görmez ve konsola yazar.

Limitler: **IP başına saat başına 30 istek**, yanıtlar beş dakika önbelleğe alınır. Bu yüzden çok ziyaretçili bir sayfa iyi çalışır, ama sayfayı sürekli yenileyen tek bir ziyaretçi için değil.

## Sayfanın neyi çağırması mümkün değil

Başka bir alanda tarayıcıya sadece `/v1/public/*` ve `/v1/embed/*` yanıt verir. `/v1/*` altındaki diğer tüm istekler preflight'ı reddeder: dış bir alandaki sayfadan `POST /v1/chart` `access-control-allow-origin` başlığı olmadan döndü ve Chrome bunu engelledi, ama aynı sayfadan `POST /v1/public/chart` `200` yanıtı verdi.

Bu yüzden ziyaretçinin doğum bilgilerini girip haritayı görmesini istiyorsan, [anahtarsız endpoint'leri](/free/) ya da tarayıcıda doğrudan hesaplayan [doğum haritası hesaplayıcı widget'ını](/products/embed-widgets/#окремий-віджет-калькулятор-натальної-карти) kullan. Gizli anahtar gerektiren her şey sunucuda çalışır: kendi sunucunda ya da [Kod Olmadan Entegrasyonlar](/integrations/) bölümündeki araçlardan birinde.

<Aside type="note" title="Коли стане в пригоді публічний ключ">
`pk_` anahtarını oluşturmalısın, eğer sayfa kendi başına `/v1/public/*`'a başvuruyorsa ve ortak ziyaretçi limiti yetersizse: ücretli planda anahtarın kendi limiti var, ve origin listesi başka bir alanda onu işe yaramaz kılıyor. Yukarıdaki widget'lar için ise tamamen gereksiz.
</Aside>