Widget-slutpunkter
Dessa slutpunkter används av SilentShields klientsida-widget. Du behöver vanligtvis inte anropa dem direkt — widgeten hanterar detta automatiskt.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Initierar en ny skyddssession för den aktuella sidan. Returnerar ett sessions-ID och konfiguration.
Auth: API-nyckel (X-Api-Key-huvud)
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}}Denna slutpunkt räknas inte mot din kvot.
POST/api/v1/captcha/telemetry
Skickar beteendetelemetridata (musrörelser, skrivetemönster, scrollbeteende) för analys.
Auth: API-nyckel (X-Api-Key-huvud)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Denna slutpunkt räknas inte mot din kvot. Data analyseras i realtid.
POST/api/v1/captcha/verdict
Begär en bedömning för den aktuella sessionen baserat på insamlad telemetridata.
Auth: API-nyckel (X-Api-Key-huvud)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Denna slutpunkt räknas som en captcha_shown-händelse om en utmaning utlöses.
POST/api/v1/captcha/verify-nonce
Verifierar en nonce som genererats av widgeten. Anropa detta från din server för att bekräfta att formulärinskickningen är legitim.
Auth: API-nyckel (X-Api-Key-huvud)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Denna slutpunkt räknas mot din kvot. Nonces är engångs och upphör efter 5 minuter.