Vidina lõpp-punktid
Neid lõpp-punkte kutsub SilentShieldi vidin. Tavaliselt ei kutsu neid ise — need on dokumenteeritud, et saaksite jälgida, mis teie lehel toimub.
Base URL: https://api.silentshield.io
POST/api/v1/telemetry/behavior
Saadab praeguse suhtluse käitumisandmed (hiir, klaviatuur, kerimine) ja tagastab nonce koos otsusega. Teie vorm saadab selle nonce väljana `behavior_nonce`.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"ts": 1767225600000, "nonce": "bh_abc123", "event": "submit", "form_key": "contact", "feature_hash": "...", "metrics": {...}, "signature": "..."}Response:
{"id": "...", "nonce": "bh_abc123", "status": "queued", "verdict": "human", "score": 0.87, "captcha_solved": false, "challenge_required": false, "difficulty": "pass", "reason_codes": [], "action": "allow"}Läheb kvoodi arvesse niipea, kui sündmus `submit` saabub koos nonce'iga — täpselt üks kord esituse kohta. `init`, `telemetry` ja `form_detected` ei loe.
POST/api/v1/captcha/challenge
Küsib arvutusülesande, kui otsus oli ebakindel. Vidin teeb seda ise; ülesanne on ühekordne ja seotud nonce'iga.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"nonce": "bh_abc123", "difficulty": "medium"}Response:
{"ok": true, "challenge_id": "ch_xyz789", "a": 7, "op": "+", "b": 5}Vajalik ainult siis, kui telemeetria vastus teatas `challenge_required: true`.
POST/api/v1/captcha/verified
Esitab lahendatud ülesande. Nonce märgitakse inimeseks alles siis, kui vastus sobib ülesandega, mille server selle võtme jaoks väljastas.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"challenge_id": "ch_xyz789", "answer": 12}Response:
{"ok": true} // 403: {"ok": false, "reason": "invalid_solution"}Fail-closed: vale või aegunud vastus annab 403 koos `reason: "invalid_solution"`. Ülesanne on ühekordne.
POST/api/v1/captcha/verify-nonce
Kontrollib vidina genereeritud nonce'i. Kutsuge seda oma serverist, et kinnitada vormi esitamise legitiimsust.
Auth: API-võti (X-Api-Key päis)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}See lõpp-punkt arvestatakse kvoodi hulka. Nonce'id on ühekordsed ja aeguvad 5 minuti pärast.