Крайни точки на уиджета
Тези крайни точки се използват от клиентския уиджет SilentShield. Обикновено не е нужно да ги извиквате директно — уиджетът се справя автоматично.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Инициализира нова сесия за защита на текущата страница. Връща идентификатор на сесия и конфигурация.
Auth: API ключ (заглавка 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}}Тази крайна точка не се брои към квотата ви.
POST/api/v1/captcha/telemetry
Изпраща данни за поведенческа телеметрия (движения на мишката, модели на писане, поведение при превъртане) за анализ.
Auth: API ключ (заглавка X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Тази крайна точка не се брои към квотата ви. Данните се анализират в реално време.
POST/api/v1/captcha/verdict
Заявява присъда за текущата сесия въз основа на събраните телеметрични данни.
Auth: API ключ (заглавка X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Тази крайна точка се брои като събитие captcha_shown, ако е задействано предизвикателство.
POST/api/v1/captcha/verify-nonce
Верифицира nonce, генериран от уиджета. Извикайте това от сървъра си, за да потвърдите, че изпращането на формуляра е легитимно.
Auth: API ключ (заглавка X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Тази крайна точка се брои към квотата ви. Nonce стойностите са за еднократна употреба и изтичат след 5 минути.