Widget-päätepisteet
Näitä päätepisteitä kutsuu SilentShield-vimpain. Yleensä et kutsu niitä itse — ne on dokumentoitu, jotta voit seurata, mitä sivullasi tapahtuu.
Base URL: https://api.silentshield.io
POST/api/v1/telemetry/behavior
Lähettää nykyisen vuorovaikutuksen käyttäytymistiedot (hiiri, näppäimistö, vieritys) ja palauttaa noncen sekä tuomion. Lomakkeesi lähettää tuon noncen kenttänä `behavior_nonce`.
Auth: API-avain (X-Api-Key-otsikko)
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"}Lasketaan kiintiöösi heti, kun tapahtuma `submit` saapuu noncen kanssa — täsmälleen kerran lähetystä kohden. `init`, `telemetry` ja `form_detected` eivät laske.
POST/api/v1/captcha/challenge
Pyytää laskutehtävän, kun tuomio oli epävarma. Vimpain tekee sen itse; tehtävä on kertakäyttöinen ja sidottu nonceen.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"nonce": "bh_abc123", "difficulty": "medium"}Response:
{"ok": true, "challenge_id": "ch_xyz789", "a": 7, "op": "+", "b": 5}Tarvitaan vain, kun telemetriavastaus ilmoitti `challenge_required: true`.
POST/api/v1/captcha/verified
Lähettää ratkaistun tehtävän. Nonce merkitään ihmiseksi vasta, kun vastaus vastaa tehtävää, jonka palvelin antoi tälle avaimelle.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"challenge_id": "ch_xyz789", "answer": 12}Response:
{"ok": true} // 403: {"ok": false, "reason": "invalid_solution"}Fail-closed: väärä tai vanhentunut vastaus palauttaa 403 ja `reason: "invalid_solution"`. Tehtävä on kertakäyttöinen.
POST/api/v1/captcha/verify-nonce
Vahvistaa widgetin luoman noncen. Kutsu tätä palvelimeltasi varmistaaksesi, että lomakkeen lähetys on aito.
Auth: API-avain (X-Api-Key-otsikko)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Tämä päätepiste lasketaan kiintiöösi. Noncet ovat kertakäyttöisiä ja vanhenevat 5 minuutin kuluttua.