Widget-végpontok
Ezeket a végpontokat a SilentShield widget hívja. Rendszerint nem Ön hívja őket — azért vannak dokumentálva, hogy követni tudja, mi történik az oldalán.
Base URL: https://api.silentshield.io
POST/api/v1/telemetry/behavior
Elküldi az aktuális interakció viselkedési adatait (egér, billentyűzet, görgetés), és visszaadja a nonce-ot az ítélettel együtt. Az űrlapja ezt a nonce-ot `behavior_nonce` mezőként küldi el.
Auth: API-kulcs (X-Api-Key fejléc)
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"}Beleszámít a keretébe, amint a `submit` esemény nonce-cal megérkezik — pontosan egyszer beküldésenként. Az `init`, `telemetry` és `form_detected` nem számít bele.
POST/api/v1/captcha/challenge
Számolási feladatot kér, ha az ítélet bizonytalan volt. A widget ezt magától teszi; a feladat egyszer használatos és a nonce-hoz kötött.
Auth: API-kulcs (X-Api-Key fejléc)
Request Body:
{"nonce": "bh_abc123", "difficulty": "medium"}Response:
{"ok": true, "challenge_id": "ch_xyz789", "a": 7, "op": "+", "b": 5}Csak akkor szükséges, ha a telemetria válasza `challenge_required: true` értéket jelzett.
POST/api/v1/captcha/verified
Beküldi a megoldott feladatot. A nonce csak akkor jelölődik emberként, ha a válasz megfelel egy feladatnak, amelyet a kiszolgáló ehhez a kulcshoz adott ki.
Auth: API-kulcs (X-Api-Key fejléc)
Request Body:
{"challenge_id": "ch_xyz789", "answer": 12}Response:
{"ok": true} // 403: {"ok": false, "reason": "invalid_solution"}Fail-closed: hibás vagy lejárt válasz 403-at ad `reason: "invalid_solution"` értékkel. A feladat egyszer használatos.
POST/api/v1/captcha/verify-nonce
Ellenőrzi a widget által generált nonce-t. Hívja meg ezt a szerveroldalról, hogy igazolja az űrlapbeküldés legitimitását.
Auth: API-kulcs (X-Api-Key fejléc)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"ok": true, "verdict": "human", "confidence": 0.95, "requested_nonce": "nonce_xyz789"}Ez a végpont beleszámít a kvótába. Minden beküldést egyszer ellenőrizzen, közvetlenül a beérkezése után.