Verifika min-Naħa tas-Server

Dejjem ivverifika n-nonce ta' SilentShield fuq is-server tiegħek. Il-kontrolli min-naħa tal-klijent biss jistgħu jiġu evitati minn bots.

Għaliex min-Naħa tas-Server?

Il-widget jaħdem fil-browser u jinjetta nonce fil-formoli. Bot jista' jaqbeż il-widget u jissottometti l-formola direttament. Il-verifika min-naħa tas-server tiżgura li n-nonce ġie maħruġ u vverifikat b'mod leġittimu minn SilentShield.

API Endpoint

Method

POST

URL

https://api.silentshield.io/api/v1/captcha/verify-nonce

Headers

X-Api-Key: YOUR_API_KEY Content-Type: application/json

Body

{ "nonce": "the-nonce-from-the-form" }

Format tar-Risposta

{
  "ok": true,
  "verdict": "human",
  "confidence": 0.92,
  "requested_nonce": "..."
}

human

human — L-utent huwa x'aktarx bniedem. Ipproċessa l-formola.

suspicious

suspicious — is-server irrifjutaha (HTTP 403, `ok: false`). Il-verdett isemmi r-raġuni, mhux id-deċiżjoni: dik diġà ttieħdet mil-limitu tal-kont tiegħek.

bot

bot — Kunfidenza għolja li dan huwa bot. Irrifjuta l-formola.

Loġika Rrakkomandata

Is-server diġà applika l-limitu tal-kont tiegħek: rifjut jasal bħala HTTP 403 b’`ok: false`. Għalhekk iċċekkja għall-approvazzjoni, mhux għal `bot` — inkella tħalli tgħaddi kull rifjut maħruġ bħala `suspicious`, u kull tweġiba mingħajr verdett (ċavetta invalida, kwota eżawrita).

if not ok or verdict != "human":
    irrifjuta l-formola (403)
else:
    ipproċessa l-formola normalment

Immaniġġjar tal-Iżbalji

Jekk l-API ta' SilentShield ma tkunx tista' tintlaħaq (timeout, żball 5xx), iddeċiedi dwar l-istrateġija tiegħek:

Fail Open

Ħalli jgħaddi — Aċċetta l-formola (esperjenza aħjar għall-utent, inqas sigura)

Fail Closed

Imblokka — Irrifjuta l-formola (iktar sigura, esperjenza agħar għall-utent)