Widget-eindpunten
Deze eindpunten worden gebruikt door de SilentShield client-side widget. U hoeft ze doorgaans niet rechtstreeks aan te roepen — de widget handelt dit automatisch af.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Initialiseert een nieuwe beschermingssessie voor de huidige pagina. Retourneert een sessie-ID en configuratie.
Auth: API-sleutel (X-Api-Key header)
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}}Dit eindpunt telt niet mee voor uw quotum.
POST/api/v1/captcha/telemetry
Verzendt gedragstelemetriegegevens (muisbewegingen, typepatronen, scrollgedrag) voor analyse.
Auth: API-sleutel (X-Api-Key header)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Dit eindpunt telt niet mee voor uw quotum. Gegevens worden in realtime geanalyseerd.
POST/api/v1/captcha/verdict
Vraagt een oordeel aan voor de huidige sessie op basis van verzamelde telemetriegegevens.
Auth: API-sleutel (X-Api-Key header)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Dit eindpunt telt als een captcha_shown-gebeurtenis als er een uitdaging wordt geactiveerd.
POST/api/v1/captcha/verify-nonce
Verifieert een nonce die door de widget is gegenereerd. Roep dit aan vanaf uw server om te bevestigen dat de formulierinzending legitiem is.
Auth: API-sleutel (X-Api-Key header)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Dit eindpunt telt mee voor uw quotum. Nonces zijn eenmalig en verlopen na 5 minuten.