Web sitesi için astrolojik widget'lar
Herkese açık HTML widget’ları GET /v1/embed/* hazır bir iframe parçası döndürür - SVG çarkı, burç yorumu, numeroloji vb. API anahtarı gerekmez, ziyaretçi IP’si başına limit (saatte 120 istek, /v1/public/* limitinden ayrıdır, yani birden fazla widget içeren bir sayfa limite takılmaz), public, max-age=300 önbelleği. Pazarlama sayfaları için uygundur; yüksek trafikli prodüksiyon için SDK kullanın.
<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>Nereden başlamalı
Section titled “Nereden başlamalı”Ekleme yöntemi, sitenizin neyle yapıldığına bağlıdır. İçerik aynıdır, fark yalnızca size ne kadar iş kaldığındadır.
| Site | Ne kullanmalı |
|---|---|
| WordPress | AstroWay eklentisi: 18 kısa kod ve 26 Gutenberg bloğu. On bir widget, kurulumdan hemen sonra, anahtar olmadan çalışır. |
| Elementor’lu WordPress | AstroWay for Elementor: yedi widget doğrudan editörde, sürükle-bırak ile. |
| Tilda, Squarespace, Wix, düz HTML | Aşağıdaki script yükleyici veya galeriden hazır <iframe>. Tek tuşla kopyalanır. |
| Kendi frontend’iniz | Aynı /v1/embed/* endpoint’leri veya sayfa düzeni üzerinde tam kontrol gerekiyorsa SDK. |
Eklentiler, bu sayfadaki endpoint’lerle aynı içeriği sunar, ancak onu temanızın tasarımında çizer ve yüksekliği elle ayarlamayı gerektirmez.
Ayrı bir widget: doğum haritası hesaplayıcı
Section titled “Ayrı bir widget: doğum haritası hesaplayıcı”Bu sayfadaki widget’lar zaten bildiğiniz şeyi çizer: tarihi, saati ve konumu siz iletirsiniz. Verileri ziyaretçinin kendisinin girmesi gerekiyorsa, başka bir widget’ımız var: doğum haritası hesaplayıcı (@astroway/widget paketi). Tek bir ekleme ile form, hesaplama ve çark; on dil, açık ve koyu tema.
Fark tasarımda değil, hesaplamanın nerede yapıldığındadır. Hesaplayıcı ziyaretçinin tarayıcısında hesaplar ve doğum verileri sunucuya hiç gitmez. /v1/embed/* widget’larını biz hesaplarız, bu yüzden parametreleri iframe adresinde görünür.
| Neye ihtiyacınız var | Ne seçmeli |
|---|---|
| Ziyaretçi kendi doğum verilerini girer | @astroway/widget hesaplayıcı |
| Doğum verileri tarayıcıdan çıkmamalı | @astroway/widget hesaplayıcı |
| Burç yorumu, transitler, tarot, numeroloji, panchang ve on iki tür daha | Bu sayfadaki widget’lar |
| On yerine yirmi dil | Bu sayfadaki widget’lar |
Script yükleyici
Section titled “Script yükleyici”iframe yüksekliğini kendiniz hesaplamak istemiyorsanız yükleyiciyi bağlayın: iframe’i kendi yerine ekler ve widget boyutunu postMessage ile bildirdiği için yüksekliği içeriğe göre otomatik olarak ayarlar.
<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>Herhangi bir data-* özniteliği bir sorgu parametresine dönüşür, yani data-theme="light" ve data-lang="en", iframe örneğindeki gibi çalışır. data-height="500" yüksekliği sabitler ve otomatik ayarlamayı kapatır. Aynı sayfadaki birden fazla widget birbirini engellemez.
Anahtar gerekmez ve kabul edilmez. /v1/embed/* endpoint’leri herkese açıktır ve bir öznitelikteki anahtar sayfanın kaynak koduna düşerdi. Yükleyici bu tür öznitelikleri konsola uyarı yazarak yok sayar.
Hangi adresi bağlamalı
Section titled “Hangi adresi bağlamalı”| Dosya | Önbellek | Kimin için |
|---|---|---|
https://cdn.astroway.info/embed.js | 5 dakika | Varsayılan seçim. Düzeltmeleri otomatik alırsınız. |
https://cdn.astroway.info/embed.v1.js | 1 yıl, immutable | Değişmezlik gerekiyorsa. Yalnızca güvenlik için güncellenir; davranış değişiklikleri embed.v2.js’ye gider. |
Widget galerisi
Section titled “Widget galerisi”16 widget’ın tamamının canlı önizlemesi. Tema ve içerik dilini seçin, kod parçasını <iframe> ile <script> yükleyici arasında değiştirin ve hazır kodu kopyalayın.
Ortak parametreler
Section titled “Ortak parametreler”Tüm widget’lar kabul eder:
| Parametre | Değerler | Varsayılan | Açıklama |
|---|---|---|---|
theme | dark · light · console | dark | Renk şeması. |
lang | uk · en · +18 dil | uk | İçerik dili. Ayrıca Accept-Language header’ından da okunur. |
disclaimer | 1 · true · yes | kapalı | Altbilgiye içeriğin eğlence ve bilgilendirme amaçlı olduğuna dair bir uyarı ekler (tıbbi, psikolojik, finansal veya hukuki danışmanlık değildir). |
Widget’lar
Section titled “Widget’lar”| Widget | Endpoint | Özel parametreler |
|---|---|---|
| Günlük burç yorumu | GET /embed/daily-horoscope | sign, date |
| Doğum çarkı | GET /embed/wheel (takma ad /embed/natal) | date, time, lat, lng, tz, city |
| Transit akışı | GET /embed/transit-timeline | date, days (maks. 30) |
| Bodygraph (Human Design) | GET /embed/bodygraph | date, time, lat, lng, tz |
| Vedik kundli | GET /embed/kundli | date, time, lat, lng, tz |
| Mini harita | GET /embed/mini-chart | date, time, lat, lng, tz, city |
| Günün gezegeni | GET /embed/planet-of-day | date |
| Ay evresi | GET /embed/moon-phase | date |
| Günün tarotu | GET /embed/daily-tarot | date |
| Aylık tahmin | GET /embed/monthly-forecast | sign, month (YYYY-MM) |
| Gökyüzü transitleri | GET /embed/transit | date |
| Numeroloji | GET /embed/numerology | name, date, system (pythagorean · chaldean) |
| Panchang | GET /embed/panchang | date, lat, lng, tz (koordinatlar zorunludur) |
| Sinastri | GET /embed/synastry | date_a, time_a, lat_a, lng_a, tz_a, date_b, time_b, lat_b, lng_b, tz_b |
| Ay takvimi | GET /embed/moon-calendar | month (YYYY-MM), tz |
| Tarot açılımı | GET /embed/tarot-spread | spread (single-card · three-card · decision · career), date, seed, reversed, art |
Biçimler: tarih - YYYY-MM-DD, saat - HH:MM, tz - UTC’den saat cinsinden fark. Belirtilmeyen parametreler akıllı varsayılanlarla doldurulur (güncel tarih, öğlen, ekvator).