Hızlı Başlangıç
Eascess'i sitenize entegre etmek yalnızca 3 adım alır.
Eascess'e ücretsiz hesap açın. Kredi kartı gerektirmez, kurulum dakikalar içinde tamamlanır.
Panel'den Domain Ekle ile sitenizin URL'sini girin. Size özel lisans anahtarı otomatik üretilir.
Oluşturulan <script> etiketini sitenizin </body> kapanışından önce yapıştırın. Widget hazır.
Domain Ekleme
Her siteniz için ayrı bir domain kaydı ve lisans anahtarı gerekir.
Giriş yaptıktan sonra sol menüden Domainler bağlantısını açın.
Sağ üstteki + Domain Ekle butonuna tıklayın ve sitenizin tam URL'sini girin (örn: https://orneksite.com).
Kayıt sonrası otomatik üretilen anahtarı kopyalayın. Bu anahtarı script etiketinin data-key değeri olarak kullanın.
Domain listesinde Tara butonuna basarak ilk WCAG uyumluluk raporunuzu alın.
Bir lisans anahtarı yalnızca kaydedildiği domain için geçerlidir. www.orneksite.com ile orneksite.com farklı kayıt gerektirebilir.
Widget Kurulumu
Widget'ı sitenize eklemek için tek bir <script> etiketi yeterlidir. Herhangi bir build adımı, npm paketi veya framework bağımlılığı yoktur.
Panel → Domainler → Script sayfasında hazır kodunuz lisans anahtarıyla birlikte görünür.
</body> kapanış etiketinden hemen önce yapıştırın. Script'in sayfanın en altında olması performansı korur.
Tarayıcıda sayfanızı açın. Sağ alt köşede Eascess widget butonu görünüyor olmalı.
Script Etiketi
Aşağıdaki script etiketini HTML'inizin </body> kapanışından hemen önce yerleştirin:
<script src="https://eascess.com/js/widget.js" data-key="YOUR_LICENSE_KEY" data-api="https://eascess.com" defer ></script>
src
Zorunlu
Widget dosyasının adresi. Dosya Eascess uygulamasının kendi alan adından servis edilir; sürüm yönetimi Eascess tarafından yapılır, her zaman güncel sürümü alırsınız.
data-api
Zorunlu
Widget'ın lisans doğrulama ve ayar isteklerini göndereceği Eascess adresi. Panel → Domainler sayfasındaki hazır etikette bu alan doldurulmuş olarak gelir.
data-key
Zorunlu
Domain'inize ait lisans anahtarı. Panel → Domainler sayfasından kopyalayın.
defer
İsteğe bağlı
Sayfa render'ını engellemez. İçeriğiniz yüklendikten sonra widget çalışır.
YOUR_LICENSE_KEY kısmını Panel → Domainler sayfanızda bulunan anahtarla değiştirin. Her domain için farklı bir anahtar üretilir.
Widget Özellikleri
Widget açıldığında kullanıcıya aşağıdaki erişilebilirlik seçenekleri sunulur:
Görünüm Ayarları
Panel → Widget Stüdyo'dan widget'ınızı marka kimliğinizle uyumlu hale getirebilirsiniz.
Widget düğmesi ve panel başlığında kullanılacak rengi seçin. HEX veya HSL değeri girebilirsiniz.
Widget butonunun görüneceği köşeyi belirleyin: sağ-alt (varsayılan), sol-alt, sağ-üst veya sol-üst.
Widget arayüzünün dilini seçin. Desteklenen diller: Türkçe, İngilizce, Almanca, Fransızca, İspanyolca.
Pro planda etkinleştirerek sayfa görsellerine otomatik alt metin enjeksiyonu yapılmasını sağlayabilirsiniz.
Ayar değişiklikleri kaydedildikten sonra widget otomatik olarak güncellenir; sayfayı yenilemenize gerek yoktur.
API Referansı
Tüm API uçnoktaları CORS korumalıdır — yalnızca kayıtlı domainlerden gelen istekler kabul edilir.
/api/license/validate
Lisans anahtarını ve domain eşleşmesini doğrular.
GET /api/license/validate?key={licenseKey}&domain={hostname} // Başarılı yanıt { "valid": true, "plan": "pro", "expiresAt": null } // Hata yanıtı { "valid": false, "reason": "invalid" }
/api/widget/config
Widget görünüm ayarlarını döndürür (tema rengi, konum, dil, AI durumu).
GET /api/widget/config?key={licenseKey} { "themeColor": "#38bdf8", "position": "bottom-right", "language": "tr", "isAiEnabled":true }
/api/scan/alt-text
Görsel URL listesi için AI destekli alt metin üretir. (Pro plan gerektirir)
// İstek gövdesi { "licenseKey": "YOUR_LICENSE_KEY", "images": [ "https://example.com/foto.jpg", "https://example.com/banner.png" ] } // Yanıt { "results": [ { "url": "...", "altText": "Masada oturan iki kişi", "cached": false } ], "processedCount": 1, "cachedCount": 0, "quotaRemaining": 1999 }
Bu belgeler sürekli güncellenmektedir. Bulamadığınız bir bilgi için bize yazın.
hello@eascess.com