Widget-päätepisteet
Näitä päätepisteitä käyttää SilentShieldin asiakaspuolen widget. Sinun ei tavallisesti tarvitse kutsua niitä suoraan — widget hoitaa tämän automaattisesti.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Alustaa uuden suojausistunnon nykyiselle sivulle. Palauttaa istuntotunnuksen ja asetukset.
Auth: API-avain (X-Api-Key-otsikko)
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}}Tämä päätepiste ei laske kiintiötäsi.
POST/api/v1/captcha/telemetry
Lähettää käyttäytymistelemetriatietoja (hiiren liikkeet, kirjoituskuviot, vierityskäyttäytyminen) analysoitavaksi.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Tämä päätepiste ei laske kiintiötäsi. Tiedot analysoidaan reaaliajassa.
POST/api/v1/captcha/verdict
Pyytää arvion nykyiselle istunnolle kerättyjen telemetriatietojen perusteella.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Tämä päätepiste lasketaan captcha_shown-tapahtumaksi, jos haaste käynnistetään.
POST/api/v1/captcha/verify-nonce
Vahvistaa widgetin luoman noncen. Kutsu tätä palvelimeltasi varmistaaksesi, että lomakkeen lähetys on aito.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Tämä päätepiste lasketaan kiintiöösi. Noncet ovat kertakäyttöisiä ja vanhenevat 5 minuutin kuluttua.