Referensi Pengembang

Panduan integrasi

Baca referensi API Markdown biasa →

Masuk dengan Google atau kode verifikasi email, lalu buka Dasbor → kunci API. Salin kunci saat ditampilkan: hanya hash SHA-256-nya yang disimpan di basis data kami. Pengguna yang ada dapat menautkan kunci lama menggunakan token manajemen privatnya.

Pemeriksaan sisi server

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

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

Respons mencakup verdict (allow, block, review), score, reason, engine (jev atau rules), model (versi penyedia pada hasil AI), execution_time_ms dan quota_remaining. Skor dari aturan adalah perkiraan heuristik. Keyakinan hanya ada untuk Jev. Perlakukan review sebagai tidak pasti, bukan blokir otomatis.

Kode status: 400 (input tidak valid), 401 (kunci hilang), 403 (kunci tidak valid), 429 (kuota habis), 503 (layanan tidak tersedia). Ukuran pesan maksimum: 10,000 karakter. Opsional business_context (hingga 1,000 karakter) menjelaskan pertanyaan yang diinginkan; jangan sertakan rahasia. Kegagalan penyedia beralih ke aturan heuristik lokal.

Log deteksi dan laporan eksekusi

Dashboard → Log deteksi menampilkan 7 hari terakhir pemeriksaan terautentikasi Anda. Pilih Uncertain — review di filter putusan untuk memeriksa hasil yang tidak pasti. Ini adalah catatan pemeriksaan dan tindakan yang dilaporkan, bukan kotak masuk atau antrean untuk menahan atau memulihkan pesan. Opsional site (URL HTTP/HTTPS; hanya nama hostnya yang disimpan) dan form_id (hingga 80 huruf, angka, garis bawah, titik dua, atau tanda hubung) mengidentifikasi integrasi Anda. Teks pesan dinonaktifkan secara default dan dapat diaktifkan di akun Anda. Pemeriksaan demo publik dikecualikan.

Pencatatan yang berhasil menambahkan check_id dan report_token ke respons pemeriksaan; logging_status disimpan atau tidak tersedia. Kegagalan pencatatan tidak mengubah klasifikasi. Simpan token laporan di server Anda. Setelah menerapkan keputusan Anda, POST ke /api/v1/report dengan kunci API yang sama:

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

Nilai tindakan yang diizinkan: allowed, blocked, atau error_allowed. Plugin WordPress terbaru melaporkan tindakannya secara otomatis. Observe only melaporkan allowed dengan alasan observe. Laporan yang hilang atau gagal muncul sebagai Not reported; tindakan allowed tidak mengonfirmasi pengiriman email.

Untuk integrasi API kustom, observasi adalah kebijakan dalam kode server Anda sendiri: panggil endpoint pemeriksaan, catat putusannya, lanjutkan alur pengiriman normal Anda, dan laporkan tindakan yang Anda terapkan. API pemeriksaan tidak secara otomatis mengaktifkan atau menonaktifkan pemblokiran di formulir Anda. Observasi tetap memproses konten pesan dan menggunakan kuota deteksi.

Pembantu browser opsional

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

Pembantu hanya memeriksa formulir yang ditandai secara eksplisit, mengirim bidang pesan, email, dan nama, dan mengizinkan pengiriman setelah kegagalan jaringan atau timeout 6 detik. Ini dapat dilewati dan mengekspos kunci API ke pengunjung. Gunakan pemeriksaan sisi server untuk penegakan dan menjaga kunci tetap privat. Uji plugin formulir AJAX sebelum mengaktifkannya.

Perutean lead

Buka Dashboard → Routing untuk mendeskripsikan bisnis Anda dan secara opsional simpan webhook atau URL pemesanan. Konteks akun digunakan saat permintaan tidak menyediakan business_context-nya sendiri. Hasil berniat tinggi dapat mengirimkan detail pertanyaan dan kontak ke webhook yang Anda konfigurasi; gunakan tujuan yang Anda kendalikan dan cantumkan pemrosesan ini dalam pemberitahuan privasi Anda.

URL pemesanan yang dikonfigurasi dikembalikan sebagai meeting_url untuk hasil dengan niat tinggi. Integrasi Anda yang memutuskan apakah akan menampilkan atau mengikutinya. Plugin WordPress dan integrasi kustom mungkin memiliki perilaku berbeda; verifikasi alur pengunjung secara lengkap. Uji webhook menggunakan pertanyaan sintetis dan mengonfirmasi respons HTTP tujuan, bukan pengiriman hilir.

Buka pengaturan routing →

WordPress

Unduh ZIP plugin JevShield terbaru, pasang di WordPress, lalu buka Pengaturan → JevShield AI dan masukkan kunci API Anda serta endpoint HTTPS /api/v1/check lengkap. Di bawah Mode Perlindungan, pilih Observe only untuk mengklasifikasikan dan mencatat tanpa diblokir oleh plugin ini. Instalasi baru dimulai dalam Observe only; instalasi yang sudah dikonfigurasi tetap memblokir hingga Anda mengubah mode. Observasi menggunakan kuota dan mengirimkan bidang pengiriman untuk diproses, jadi jelaskan hal ini dalam pemberitahuan privasi Anda. Periksa pengiriman formulir Anda yang sebenarnya sebelum beralih ke Block high-confidence spam.

JevShield juga terdaftar di Direktori Plugin WordPress.org. Rilis direktori mungkin tiba lebih lambat daripada ZIP di sini; jika Mode Perlindungan tidak ada, perbarui menggunakan ZIP terbaru. Plugin FormShield legacy yang terpisah mempertahankan pengaturan dan jalur pembaruannya yang ada. Pengaturan konteks bisnis dan override email persisnya belum ditambahkan ke plugin JevShield. API masih menerima business_context untuk integrasi kustom.