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
Section titled “Bir snippet’i ekle”Boyutu bilinen normal iframe:
<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.
<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. Her data-* özniteliği istek parametresi olur.
Kodu nereye eklemeli
Section titled “Kodu nereye eklemeli”| Site Oluşturucu | Ne aramalı |
|---|---|
| Wix | HTML kod ekleme öğesi |
| Squarespace | kod bloğu |
| 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
Section titled “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
Section titled “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 ya da tarayıcıda doğrudan hesaplayan doğum haritası hesaplayıcı widget’ını kullan. Gizli anahtar gerektiren her şey sunucuda çalışır: kendi sunucunda ya da Kod Olmadan Entegrasyonlar bölümündeki araçlardan birinde.