Končne točke gradnika
Te končne točke uporablja odjemalski gradnik SilentShield. Običajno jih ni treba klicati neposredno — gradnik to opravi samodejno.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inicializira novo sejo zaščite za trenutno stran. Vrne ID seje in konfiguracijo.
Auth: API ključ (glava X-Api-Key)
Request Body:
{"domain": "example.com", "page": "/contact"}Response:
{"sessionId": "sess_abc123", "features": {"telemetry": true, "pow": true, "honeypot": true}, "threshold": {"suspicious": 0.6, "block": 0.3}}Ta končna točka se ne šteje v vašo kvoto.
POST/api/v1/captcha/telemetry
Pošlje podatke vedenjske telemetrije (premiki miške, vzorci tipkanja, vedenje drsenja) za analizo.
Auth: API ključ (glava X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Ta končna točka se ne šteje v vašo kvoto. Podatki se analizirajo v realnem času.
POST/api/v1/captcha/verdict
Zahteva sodbo za trenutno sejo na podlagi zbranih telemetričnih podatkov.
Auth: API ključ (glava X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Ta končna točka se šteje kot dogodek captcha_shown, če se sproži izziv.
POST/api/v1/captcha/verify-nonce
Preveri nonce, ki ga je ustvaril gradnik. Pokličite to s svojega strežnika, da potrdite, da je oddaja obrazca legitimna.
Auth: API ključ (glava X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Ta končna točka se šteje v vašo kvoto. Vrednosti nonce so za enkratno uporabo in potečejo po 5 minutah.