Web SDK

Web SDK tüm modern tarayıcıları destekler ve birden fazla entegrasyon yöntemi sunar.

30 saniyede çalışırken görün

demo-v1.captcha.la — saf HTML + PHP, MIT lisanslı, her sayfada view-source açıktır.

• popup.html — açılır pencere modu
• float.html — kayan widget
• bind.html — butona bağla
• inline.html — satır içi gömme
• server-token.html — sunucu tarafından düzenlenen token (yeniden oynatma engelleme)

Hızlı başlangıç

<!-- 1. Load via CDN (or npm install captchala) -->
<script src="https://cdn.captcha-cdn.net/captchala-loader.js"></script>

<button id="login-btn">Sign in</button>

<script>
loadCaptchala(function () {
  Captchala.init({
    appKey: 'YOUR_APP_KEY',
    product: 'bind',
    action: 'login',
    lang: 'auto',
  })
  .onSuccess(res => sendToBackend(res.token))
  .onError(err => console.error(err.message))
  .bindTo('#login-btn');
});
</script>

Kurulum

CDN

<!-- Recommended: auto-fallback loader, ~6 KB gzip -->
<script src="https://cdn.captcha-cdn.net/captchala-loader.js"></script>

NPM

npm install captchala
# or framework wrappers
npm install @captcha-la/vue
npm install @captcha-la/react

import Captchala from 'captchala';
import 'captchala/dist/captchala.css';

Modlar

Açılır Pencere Modu

Captchala.init({ appKey: 'YOUR_APP_KEY', product: 'popup', action: 'login' })
  .bindTo('#login-btn')
  .onSuccess(res => sendToBackend(res.token));

Kayan Mod

Captchala.init({ appKey: 'YOUR_APP_KEY', product: 'float', action: 'browse' })
  .appendTo('#captcha-container')
  .onSuccess(res => sendToBackend(res.token));

Bağla Modu

Captchala.init({ appKey: 'YOUR_APP_KEY', product: 'bind', action: 'login' })
  .bindTo('#submit-button')
  .onSuccess(res => submitForm(res.token));   // fires only after challenge passes

Gömme Modu

Captchala.init({ appKey: 'YOUR_APP_KEY', product: 'embed', action: 'register' })
  .appendTo('#captcha-container')
  .onSuccess(res => sendToBackend(res.token));

Ortak seçenekler

Parametre	Tür	Varsayılan	Açıklama
appKey	string	—	Uygulama Anahtarı (zorunlu)
product	string	popup	Görüntüleme modu: popup
action	string	default	İş senaryosu (örn. login, register, pay). Sunucu her senaryoya farklı güvenlik politikaları uygular.
lang	string	auto	BCP-47 etiketi (örn. en, ja, pt-BR) veya navigator.language değerini takip etmek için auto. Bkz. Desteklenen diller — 54 yerel ayar.
serverToken	string	—	Sunucunuz tarafından düzenlenen tek kullanımlık token (sct_xxx). Üretimde şiddetle tavsiye edilir — sınırsız challenge yenileme kötüye kullanımını önler.
onServerTokenExpired	() => Promise<string>	—	serverToken süresi dolduğunda çağrılır; SDK'nın akışı kesintiye uğratmadan devam edebilmesi için yenisini döndürün.
enableVoice	boolean	true	Sesli CAPTCHA giriş noktasını göster (görme engelli kullanıcılar için erişilebilirlik desteği).

Sunucu tarafı doğrulama

onSuccess sonrası, res.token değerini (pt_ ön ekli) kendi backend'inize gönderin ve sunucu tarafında doğrulayın:

POST https://apiv1.captcha.la/v1/validate
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
Content-Type: application/json

{ "pass_token": "<token>", "client_ip": "<end-user IP>" }

Tam doğrulama uç noktası için API Referansı'na bakın.