Geliştirici Referansı

Entegrasyon kılavuzu

Düz Markdown API referansını okuyun →

Google ile oturum açın veya bir e-posta doğrulama kodu kullanın, ardından Kontrol Paneli → API anahtarı'nı açın. Anahtar gösterildiğinde kopyalayın: veritabanımızda yalnızca SHA-256 karması saklanır. Mevcut kullanıcılar, özel yönetim token'ını kullanarak eski bir anahtarı bağlayabilir.

Sunucu taraflı kontrol

POST /api/v1/check
Content-Type: application/json
x-api-key: YOUR_API_KEY

{
  "text": "Can you quote this project?",
  "email": "[email protected]"
}

Yanıtlar şunları içerir verdict (allow, block, review), score, reason, engine (jev veya rules), model (AI sonuçlarında sağlayıcı sürümü), execution_time_ms ve quota_remaining. Kurallardan gelen puanlar sezgisel tahminlerdir. Güven yalnızca Jev için mevcuttur. Review'ı otomatik bir engelleme değil, belirsiz olarak değerlendirin.

Durum kodları: 400 (geçersiz girdi), 401 (eksik anahtar), 403 (geçersiz anahtar), 429 (kota tükendi), 503 (hizmet kullanılamıyor). Maksimum mesaj boyutu: 10.000 karakter. İsteğe bağlı business_context (1.000 karaktere kadar) istenen sorguları açıklar; sırları dahil etmeyin. Sağlayıcı hatası yerel sezgisel kurallara geri döner.

Algılama günlükleri ve yürütme raporları

Panel → Algılama günlükleri, son 7 günlük kimliği doğrulanmış kontrollerinizi gösterir. Belirsiz sonuçları incelemek için karar filtresinde Belirsiz — incele seçeneğini seçin. Bu, mesajları tutma veya geri yükleme için bir gelen kutusu ya da kuyruk değil, kontrollerin ve bildirilen eylemlerin kaydıdır. İsteğe bağlı site (bir HTTP/HTTPS URL'si; yalnızca ana bilgisayar adı saklanır) ve form_id (80'e kadar harf, sayı, alt çizgi, iki nokta üst üste veya tire) entegrasyonunuzu tanımlar. Mesaj metni varsayılan olarak kapalıdır ve hesabınızda etkinleştirilebilir. Genel demo kontrolleri hariç tutulur.

Başarılı günlük kaydı şunu ekler: check_id ve report_token check yanıtına; logging_status saved veya unavailable olur. Günlükleme hataları sınıflandırmayı değiştirmez. Rapor token'ını sunucunuzda saklayın. Kararınızı uyguladıktan sonra şu adrese POST yapın: /api/v1/report aynı API anahtarıyla:

{
  "check_id": "CHECK_UUID",
  "report_token": "TOKEN_FROM_CHECK",
  "action": "allowed",
  "reason": "verdict"
}

İzin verilen eylem değerleri: allowed, blocked, veya error_allowed. En son WordPress eklentisi eylemini otomatik olarak bildirir. Observe only, observe nedeniyle izin verilenleri bildirir. Eksik veya başarısız bir rapor Bildirilmedi olarak görünür; izin verilen bir eylem e-posta teslimatını doğrulamaz.

Özel bir API entegrasyonu için gözlem, kendi sunucu kodunuzdaki bir politikadır: kontrol uç noktasını çağırın, kararı kaydedin, normal gönderim akışınıza devam edin ve uyguladığınız eylemi bildirin. Kontrol API'si formunuzda engellemeyi otomatik olarak açmaz veya kapatmaz. Gözlem yine de mesaj içeriğini işler ve algılama kotasını kullanır.

İsteğe bağlı tarayıcı yardımcısı

<form data-formshield> ... </form>
<script src="https://jevshield.com/shield.js" data-key="YOUR_API_KEY"></script>

Yardımcı yalnızca açıkça işaretlenmiş formları kontrol eder, mesaj, e-posta ve ad alanlarını gönderir ve bir ağ hatası veya 6 saniyelik zaman aşımından sonra gönderime izin verir. Atlatılabilir ve API anahtarını ziyaretçilere açık eder. Zorunlu kılma için ve anahtarı gizli tutmak için sunucu tarafı kontrolleri kullanın. Etkinleştirmeden önce AJAX form eklentilerini test edin.

Potansiyel müşteri yönlendirme

İşletmenizi tanımlamak için Dashboard → Routing'i açın ve isteğe bağlı olarak bir webhook veya rezervasyon URL'si kaydedin. Hesap bağlamı, bir istek kendi business_context'ini sağlamadığında kullanılır. Yüksek niyetli sonuçlar talep ve iletişim bilgilerini yapılandırdığınız webhook'a gönderebilir; kontrol ettiğiniz bir hedef kullanın ve bu işlemeyi gizlilik bildiriminizde belirtin.

Yapılandırılmış bir rezervasyon URL'si, yüksek niyetli sonuçlar için meeting_url olarak döndürülür. Görüntülenip görüntülenmeyeceğine veya takip edilip edilmeyeceğine entegrasyonunuz karar verir. WordPress eklentisi ve özel entegrasyonlar farklı davranışlara sahip olabilir; eksiksiz ziyaretçi akışını doğrulayın. Bir webhook testi sentetik bir talep kullanır ve hedef HTTP yanıtını doğrular, alt akış teslimatını değil.

Yönlendirme ayarlarını açın →

WordPress

En son JevShield eklenti ZIP'ini indirin, WordPress'e kurun, ardından Ayarlar → JevShield AI bölümünü açın ve API anahtarınızı ve tam HTTPS /api/v1/check uç noktasını girin. Koruma Modu altında, bu eklenti engellemeden sınıflandırmak ve günlüğe kaydetmek için yalnızca Observe'u seçin. Yeni kurulumlar yalnızca Observe modunda başlar; mevcut yapılandırılmış kurulumlar siz modu değiştirene kadar engellemeyi sürdürür. Gözlem kota kullanır ve işlenmek üzere gönderim alanlarını iletir, bu nedenle gizlilik bildiriminizde bunu açıklayın. Yüksek güvenilirlikli spam'i engellemeye geçmeden önce formunuzun gerçek teslimatını kontrol edin.

JevShield ayrıca şurada listelenmiştir: WordPress.org Eklenti Dizini. Dizin sürümleri buradaki ZIP'ten daha geç gelebilir; Koruma Modu eksikse en son ZIP ile güncelleyin. Ayrı eski FormShield eklentisi mevcut ayarlarını ve güncelleme yolunu korur. İş bağlamı ve tam e-posta geçersiz kılma ayarları JevShield eklentisine eklenmemiştir. API, özel entegrasyonlar için business_context'i hâlâ kabul eder.