Koncové body widgetu
Tieto koncové body používa klientský widget SilentShield. Zvyčajne ich nemusíte volať priamo — widget to rieši automaticky.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inicializuje novú ochrannú reláciu pre aktuálnu stránku. Vracia ID relácie a konfiguráciu.
Auth: API kľúč (hlavička 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}}Tento koncový bod sa nepočíta do kvóty.
POST/api/v1/captcha/telemetry
Odosiela telemetrické údaje o správaní (pohyby myši, vzorce písania, správanie pri posúvaní) na analýzu.
Auth: API kľúč (hlavička X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Tento koncový bod sa nepočíta do kvóty. Údaje sú analyzované v reálnom čase.
POST/api/v1/captcha/verdict
Vyžiada verdikt pre aktuálnu reláciu na základe zozbieraných telemetrických údajov.
Auth: API kľúč (hlavička X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Tento koncový bod sa počíta ako udalosť captcha_shown, ak je spustená výzva.
POST/api/v1/captcha/verify-nonce
Overí nonce vygenerovaný widgetom. Zavolajte toto zo svojho servera na potvrdenie, že odoslanie formulára je legitímne.
Auth: API kľúč (hlavička X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Tento koncový bod sa počíta do kvóty. Nonce sú jednorazové a vypršia po 5 minútach.