API & Entegrasyon Dökümantasyonu

Genel Bakış

Tüm istekler HTTPS üzerinden yapılır. Taban adres:

https://www.aieditor.com.tr/api

Kimlik Doğrulama

Müşteri API'si Authorization: Bearer <api_token> başlığı ister. Token'ı API & Entegrasyon sayfasından üretip yenileyebilirsiniz. İsteğe bağlı IP beyaz listesi ile token'ın kullanılabileceği adresleri sınırlayın.

Lisans Doğrulama

SDK ve sunucu tarafı entegrasyon lisansı bu endpoint ile doğrular:

POST https://www.aieditor.com.tr/api/license/verify
Content-Type: application/json

{ "licenseKey": "LIC-XXXX-XXXX-XXXX-XXXX", "domain": "site.com" }

Yanıt status: "ok" veya hata kodu döner. Güvenilir host, isteğin geldiği başlıklardan sunucu tarafında türetilir.

Webhook

Lisans olayları (aktivasyon, ihlal, iptal) için https:// webhook adresi tanımlayın; istekler webhook_secret ile imzalanır. Ayarlar: API & Entegrasyon → Webhook.

IP Beyaz Liste

API token'ının yalnızca belirli IP / CIDR bloklarından kullanılmasına izin verin. Boş bırakılırsa kısıtlama uygulanmaz.

Entegrasyon Şablonları

Hazır kod örnekleri: Saf HTML, PHP / Laravel, React, Vue 3.

SDK Kurulumu

licenseEndpoint ve productKey değerleri aieditor.js içine gömülüdür; müşteri snippet'inde yalnızca licenseKey tanımlanır. Editör bir yapıcı (constructor) ile başlatılır: new AiEditor(seçici, ayarlar).

<!-- 1) Stil -->
<link rel="stylesheet" href="/assets/editor/aieditor.css">

<!-- 2) Yapılandırma + çoklu dil + çekirdek -->
<script src="/assets/editor/aieditor.config.js"></script>
<script src="/assets/editor/aieditor.i18n.js"></script>
<script src="/assets/editor/aieditor.js"></script>

<!-- 3) Taşıyıcı -->
<div id="editor"></div>

<!-- 4) Başlatma -->
<script>
  const editor = new AiEditor('#editor', {
    lang: 'tr',
    licenseKey: 'LIC-XXXX-XXXX-XXXX-XXXX',
    placeholder: 'Yazmaya başlayın...'
  });
</script>