Logrīka galapunkti
Šos galapunktus izsauc SilentShield logrīks. Parasti jūs tos neizsaucat paši — tie ir dokumentēti, lai varētu sekot līdzi tam, kas notiek jūsu lapā.
Base URL: https://api.silentshield.io
POST/api/v1/telemetry/behavior
Nosūta pašreizējās mijiedarbības uzvedības datus (pele, tastatūra, ritināšana) un atgriež nonce kopā ar spriedumu. Jūsu veidlapa šo nonce nosūta kā lauku `behavior_nonce`.
Auth: API atslēga (X-Api-Key galvene)
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"}Tiek ieskaitīts jūsu kvotā, tiklīdz notikums `submit` pienāk ar nonce — tieši vienu reizi katrā iesniegšanā. `init`, `telemetry` un `form_detected` netiek skaitīti.
POST/api/v1/captcha/challenge
Pieprasa rēķina uzdevumu, ja spriedums bija nedrošs. Logrīks to dara pats; uzdevums ir vienreizējs un piesaistīts nonce.
Auth: API atslēga (X-Api-Key galvene)
Request Body:
{"nonce": "bh_abc123", "difficulty": "medium"}Response:
{"ok": true, "challenge_id": "ch_xyz789", "a": 7, "op": "+", "b": 5}Nepieciešams tikai tad, ja telemetrijas atbilde ziņoja `challenge_required: true`.
POST/api/v1/captcha/verified
Iesniedz atrisināto uzdevumu. Nonce tiek atzīmēts kā cilvēks tikai tad, ja atbilde sakrīt ar uzdevumu, ko serveris izdevis šai atslēgai.
Auth: API atslēga (X-Api-Key galvene)
Request Body:
{"challenge_id": "ch_xyz789", "answer": 12}Response:
{"ok": true} // 403: {"ok": false, "reason": "invalid_solution"}Fail-closed: nepareiza vai novecojusi atbilde atgriež 403 ar `reason: "invalid_solution"`. Uzdevums ir vienreizējs.
POST/api/v1/captcha/verify-nonce
Verificē logrīka ģenerētu nonce. Izsauciet to no sava servera, lai apstiprinātu, ka formas iesniegšana ir leģitīma.
Auth: API atslēga (X-Api-Key galvene)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Šis galapunkts tiek ieskaitīts jūsu kvotā. Nonce ir vienreizlietojami un to derīguma termiņš beidzas pēc 5 minūtēm.