Widget vegpontok
Ezeket a vegpontokat a SilentShield kliensoldali widget hasznalja. Altalaban nem kell kozvetlenul hivnia oket — a widget automatikusan kezeli.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Uj vedelmi munkamenetet inicializal az aktualis oldalhoz. Visszaad egy munkamenet-azonositot es konfiguraciot.
Auth: API-kulcs (X-Api-Key fejlec)
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}}Ez a vegpont nem szamit bele a kvotaba.
POST/api/v1/captcha/telemetry
Viselkedesi telemetriai adatokat kuld (egermozgasok, gepelesi mintak, gorgetes viselkedes) elemzesre.
Auth: API-kulcs (X-Api-Key fejlec)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Ez a vegpont nem szamit bele a kvotaba. Az adatok valos idoben kerul elemzesre.
POST/api/v1/captcha/verdict
Verdiktet ker az aktualis munkamenethez az osszegyujtott telemetriai adatok alapjan.
Auth: API-kulcs (X-Api-Key fejlec)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Ez a vegpont captcha_shown esemenkent szamit, ha kihivas indul.
POST/api/v1/captcha/verify-nonce
Ellenorzi a widget altal generalt nonce-t. Hivja meg ezt a szerveroldlarol az urlap bekuldese legitimtasanak igazolasara.
Auth: API-kulcs (X-Api-Key fejlec)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Ez a vegpont beleszamit a kvotaba. A nonce-ok egyszeri hasznalatuak es 5 perc utan lejarnak.