SilentShield

Endpoints tal-Widget

Dawn l-endpoints jissejħu mill-widget ta’ SilentShield. Normalment ma ssejħilhomx int — huma dokumentati biex issegwi x’qed jiġri fuq il-paġna tiegħek.

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

POST/api/v1/telemetry/behavior

Jibgħat id-data tal-imġiba tal-interazzjoni attwali (maws, tastiera, scroll) u jirritorna n-nonce flimkien ma’ verdett. Il-formola tiegħek tibgħat dak in-nonce bħala l-qasam `behavior_nonce`.

Auth: Ċavetta API (header 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"}

Jgħodd mal-kwota tiegħek malli l-avveniment `submit` jasal b’nonce — eżattament darba għal kull sottomissjoni. `init`, `telemetry` u `form_detected` ma jgħoddux.

POST/api/v1/captcha/challenge

Jitlob eżerċizzju ta’ kalkolu meta l-verdett kien inċert. Il-widget jagħmel dan waħdu; l-eżerċizzju jintuża darba u huwa marbut man-nonce.

Auth: Ċavetta API (header X-Api-Key)

Request Body:

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

Response:

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

Meħtieġ biss meta t-tweġiba tat-telemetrija rrappurtat `challenge_required: true`.

POST/api/v1/captcha/verified

Jibgħat l-eżerċizzju solvut. In-nonce jiġi mmarkat bħala uman biss meta t-tweġiba taqbel ma’ eżerċizzju li s-server ħareġ għal din iċ-ċavetta.

Auth: Ċavetta API (header X-Api-Key)

Request Body:

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

Response:

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

Fail-closed: tweġiba żbaljata jew skaduta tirritorna 403 b’`reason: "invalid_solution"`. L-eżerċizzju jintuża darba.

POST/api/v1/captcha/verify-nonce

Jivverifika nonce iġġenerat mill-widget. Sejjaħ dan mis-server tiegħek biex tikkonferma li s-sottomissjoni tal-formola hija leġittima.

Auth: Ċavetta API (header X-Api-Key)

Request Body:

{"nonce": "nonce_xyz789"}

Response:

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

Dan l-endpoint jingħadd fil-kwota tiegħek. In-nonces jintużaw darba waħda u jiskadu wara 5 minuti.