Logrīka galapunkti

Šos galapunktus izmanto SilentShield klienta puses logrīks. Parasti jums nav jāizsauc tie tieši — logrīks to apstrādā automātiski.

Base URL: https://api.silentshield.io

POST/api/v1/captcha/init

Inicializē jaunu aizsardzības sesiju pašreizējai lapai. Atgriež sesijas ID un konfigurāciju.

Auth: API atslēga (X-Api-Key galvene)

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 galapunkts netiek ieskaitīts jūsu kvotā.

POST/api/v1/captcha/telemetry

Iesniedz uzvedības telemetrijas datus (peles kustības, rakstīšanas modeļi, ritināšanas uzvedība) analīzei.

Auth: API atslēga (X-Api-Key galvene)

Request Body:

{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}

Response:

{"received": true}

Šis galapunkts netiek ieskaitīts jūsu kvotā. Dati tiek analizēti reāllaikā.

POST/api/v1/captcha/verdict

Pieprasa spriedumu pašreizējai sesijai, pamatojoties uz savāktajiem telemetrijas datiem.

Auth: API atslēga (X-Api-Key galvene)

Request Body:

{"sessionId": "sess_abc123"}

Response:

{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}

Šis galapunkts tiek ieskaitīts kā captcha_shown notikums, ja tiek aktivizēts izaicinājums.

POST/api/v1/captcha/verify-nonce

Verificē logrīka ģenerētu nonce. Izsauciet to no sava servera, lai apstiprinātu, ka formas iesniegšana ir leģitīma.

Auth: API atslēga (X-Api-Key galvene)

Request Body:

{"nonce": "nonce_xyz789"}

Response:

{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}

Šis galapunkts tiek ieskaitīts jūsu kvotā. Nonce ir vienreizlietojami un to derīguma termiņš beidzas pēc 5 minūtēm.