Endpoint-uri widget
Aceste endpoint-uri sunt utilizate de widget-ul client SilentShield. De obicei nu trebuie să le apelați direct — widget-ul gestionează acest lucru automat.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Inițializează o nouă sesiune de protecție pentru pagina curentă. Returnează un ID de sesiune și configurarea.
Auth: Cheie API (antet 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}}Acest endpoint nu se numără în cota dumneavoastră.
POST/api/v1/captcha/telemetry
Trimite date de telemetrie comportamentală (mișcări de mouse, tipare de tastare, comportament de derulare) pentru analiză.
Auth: Cheie API (antet X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Acest endpoint nu se numără în cota dumneavoastră. Datele sunt analizate în timp real.
POST/api/v1/captcha/verdict
Solicită un verdict pentru sesiunea curentă bazat pe datele de telemetrie colectate.
Auth: Cheie API (antet X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Acest endpoint se numără ca eveniment captcha_shown dacă se declanșează o provocare.
POST/api/v1/captcha/verify-nonce
Verifică un nonce generat de widget. Apelați-l de pe server pentru a confirma că trimiterea formularului este legitimă.
Auth: Cheie API (antet X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Acest endpoint se numără în cota dumneavoastră. Valorile nonce sunt de unică folosință și expiră după 5 minute.