Valdiklio galiniai taškai
Šiuos galinius taškus naudoja SilentShield kliento pusės valdiklis. Paprastai jums nereikia jų kviesti tiesiogiai — valdiklis tai atlieka automatiškai.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inicializuoja naują apsaugos sesiją dabartiniam puslapiui. Grąžina sesijos ID ir konfigūraciją.
Auth: API raktas (X-Api-Key antraštė)
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}}Šis galinis taškas nėra skaičiuojamas kvotai.
POST/api/v1/captcha/telemetry
Pateikia elgesio telemetrijos duomenis (pelės judesius, rašymo modelius, slinkimo elgesį) analizei.
Auth: API raktas (X-Api-Key antraštė)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Šis galinis taškas nėra skaičiuojamas kvotai. Duomenys analizuojami realiu laiku.
POST/api/v1/captcha/verdict
Užklausia sprendimo dabartinei sesijai pagal surinktus telemetrijos duomenis.
Auth: API raktas (X-Api-Key antraštė)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Šis galinis taškas skaičiuojamas kaip captcha_shown įvykis, jei iššūkis suaktyvinamas.
POST/api/v1/captcha/verify-nonce
Patikrina valdiklio sugeneruotą nonce. Iškvieskite tai iš savo serverio, kad patvirtintumėte formos pateikimo teisėtumą.
Auth: API raktas (X-Api-Key antraštė)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Šis galinis taškas skaičiuojamas kvotai. Nonce yra vienkartiniai ir galioja 5 minutes.