Endpoints tal-Widget
Dawn l-endpoints jintużaw mill-widget tal-klijent ta' SilentShield. Normalment m'għandekx bżonn issejħilhom direttament — il-widget jimmaniġġja dan awtomatikament.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inizjalizza sessjoni ġdida ta' protezzjoni għall-paġna attwali. Jirritorna session ID u konfigurazzjoni.
Auth: Ċavetta API (header X-Api-Key)
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}}Dan l-endpoint ma jingħaddx fil-kwota tiegħek.
POST/api/v1/captcha/telemetry
Jibgħat data tat-telemetrija tal-imġiba (movimenti tal-maws, mudelli tat-typing, imġiba tal-iskrolling) għall-analiżi.
Auth: Ċavetta API (header X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Dan l-endpoint ma jingħaddx fil-kwota tiegħek. Id-data tiġi analizzata f'ħin reali.
POST/api/v1/captcha/verdict
Jitlob verdict għas-sessjoni attwali bbażat fuq id-data tat-telemetrija miġbura.
Auth: Ċavetta API (header X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Dan l-endpoint jingħadd bħala avveniment captcha_shown jekk tiġi attivata sfida.
POST/api/v1/captcha/verify-nonce
Jivverifika nonce iġġenerat mill-widget. Sejjaħ dan mis-server tiegħek biex tikkonferma li s-sottomissjoni tal-formola hija leġittima.
Auth: Ċavetta API (header X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Dan l-endpoint jingħadd fil-kwota tiegħek. In-nonces jintużaw darba waħda u jiskadu wara 5 minuti.