Vidina lõpp-punktid
Neid lõpp-punkte kasutab SilentShield kliendipoolne vidin. Tavaliselt ei pea te neid otse kutsuma — vidin teeb seda automaatselt.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Lähtestab uue kaitseseansi praeguse lehe jaoks. Tagastab seansi ID ja seadistuse.
Auth: API-võti (X-Api-Key päis)
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}}See lõpp-punkt ei arvestata kvoodi hulka.
POST/api/v1/captcha/telemetry
Esitab käitumise telemeetriaandmed (hiireliigutused, trükkimismustrid, kerimiskäitumine) analüüsiks.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}See lõpp-punkt ei arvestata kvoodi hulka. Andmeid analüüsitakse reaalajas.
POST/api/v1/captcha/verdict
Küsib praeguse seansi otsust kogutud telemeetriaandmete põhjal.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}See lõpp-punkt arvestatakse captcha_shown sündmusena, kui väljakutse käivitatakse.
POST/api/v1/captcha/verify-nonce
Kontrollib vidina genereeritud nonce'i. Kutsuge seda oma serverist, et kinnitada vormi esitamise legitiimsust.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}See lõpp-punkt arvestatakse kvoodi hulka. Nonce'id on ühekordsed ja aeguvad 5 minuti pärast.