SilentShield

Končne točke gradnika

Te končne točke kliče pripomoček SilentShield. Običajno jih ne kličete sami — dokumentirane so, da lahko sledite, kaj se dogaja na vaši strani.

Base URL: https://api.silentshield.io

POST/api/v1/telemetry/behavior

Pošlje vedenjske podatke trenutne interakcije (miška, tipkovnica, pomikanje) in vrne nonce skupaj z razsodbo. Vaš obrazec ta nonce pošlje kot polje `behavior_nonce`.

Auth: API ključ (glava X-Api-Key)

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"}

Šteje v vašo kvoto takoj, ko dogodek `submit` prispe z noncem — natanko enkrat na oddajo. `init`, `telemetry` in `form_detected` se ne štejejo.

POST/api/v1/captcha/challenge

Zahteva računsko nalogo, kadar je bila razsodba negotova. Pripomoček to stori sam; naloga je enkratna in vezana na nonce.

Auth: API ključ (glava X-Api-Key)

Request Body:

{"nonce": "bh_abc123", "difficulty": "medium"}

Response:

{"ok": true, "challenge_id": "ch_xyz789", "a": 7, "op": "+", "b": 5}

Potrebno le, kadar je odgovor telemetrije javil `challenge_required: true`.

POST/api/v1/captcha/verified

Odda rešeno nalogo. Nonce se označi kot človeški šele, ko se odgovor ujema z nalogo, ki jo je strežnik izdal za ta ključ.

Auth: API ključ (glava X-Api-Key)

Request Body:

{"challenge_id": "ch_xyz789", "answer": 12}

Response:

{"ok": true}   //  403: {"ok": false, "reason": "invalid_solution"}

Fail-closed: napačen ali potekel odgovor vrne 403 z `reason: "invalid_solution"`. Naloga je enkratna.

POST/api/v1/captcha/verify-nonce

Preveri nonce, ki ga je ustvaril gradnik. Pokličite to s svojega strežnika, da potrdite, da je oddaja obrazca legitimna.

Auth: API ključ (glava X-Api-Key)

Request Body:

{"nonce": "nonce_xyz789"}

Response:

{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}

Ta končna točka se šteje v vašo kvoto. Vrednosti nonce so za enkratno uporabo in potečejo po 5 minutah.