Krajnje točke widgeta
Ove krajnje točke koristi SilentShield klijentski widget. Obično ih ne trebate pozivati izravno — widget to obrađuje automatski.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inicijalizira novu sesiju zaštite za trenutnu stranicu. Vraća ID sesije i konfiguraciju.
Auth: API ključ (zaglavlje 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}}Ova krajnja točka ne broji se u vašu kvotu.
POST/api/v1/captcha/telemetry
Šalje podatke bihevioralne telemetrije (pokrete miša, obrasce tipkanja, ponašanje pri pomicanju) za analizu.
Auth: API ključ (zaglavlje X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Ova krajnja točka ne broji se u vašu kvotu. Podaci se analiziraju u stvarnom vremenu.
POST/api/v1/captcha/verdict
Zahtijeva presudu za trenutnu sesiju na temelju prikupljenih telemetrijskih podataka.
Auth: API ključ (zaglavlje X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Ova krajnja točka broji se kao događaj captcha_shown ako je izazov aktiviran.
POST/api/v1/captcha/verify-nonce
Verificira nonce generiran od widgeta. Pozovite ovo sa svog poslužitelja kako biste potvrdili da je slanje obrasca legitimno.
Auth: API ključ (zaglavlje X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Ova krajnja točka broji se u vašu kvotu. Nonce vrijednosti su jednokratne i istječu nakon 5 minuta.