Endpoints Widget
Αυτά τα endpoints χρησιμοποιούνται από το widget πελάτη SilentShield. Συνήθως δεν χρειάζεται να τα καλέσετε απευθείας — το widget τα διαχειρίζεται αυτόματα.
Base URL: https://api.silentshield.io
POST/api/v1/captcha/init
Αρχικοποιεί μια νέα συνεδρία προστασίας για την τρέχουσα σελίδα. Επιστρέφει αναγνωριστικό συνεδρίας και ρυθμίσεις.
Auth: Κλειδί API (κεφαλίδα X-Api-Key)
Request Body:
{"domain": "example.com", "page": "/contact"}Response:
{"sessionId": "sess_abc123", "features": {"telemetry": true, "pow": true, "honeypot": true}, "threshold": {"suspicious": 0.6, "block": 0.3}}Αυτό το endpoint δεν μετράει στο όριό σας.
POST/api/v1/captcha/telemetry
Υποβάλλει δεδομένα τηλεμετρίας συμπεριφοράς (κινήσεις ποντικιού, μοτίβα πληκτρολόγησης, συμπεριφορά κύλισης) για ανάλυση.
Auth: Κλειδί API (κεφαλίδα X-Api-Key)
Request Body:
{"sessionId": "sess_abc123", "events": [{"type": "mousemove", "ts": 1234567890, "data": {...}}]}Response:
{"received": true}Αυτό το endpoint δεν μετράει στο όριό σας. Τα δεδομένα αναλύονται σε πραγματικό χρόνο.
POST/api/v1/captcha/verdict
Ζητά ετυμηγορία για την τρέχουσα συνεδρία βάσει των συλλεχθέντων δεδομένων τηλεμετρίας.
Auth: Κλειδί API (κεφαλίδα X-Api-Key)
Request Body:
{"sessionId": "sess_abc123"}Response:
{"verdict": "human", "score": 0.92, "nonce": "nonce_xyz789", "challengeRequired": false}Αυτό το endpoint μετράει ως συμβάν captcha_shown εάν ενεργοποιηθεί πρόκληση.
POST/api/v1/captcha/verify-nonce
Επαληθεύει ένα nonce που δημιουργήθηκε από το widget. Καλέστε το από τον διακομιστή σας για να επιβεβαιώσετε ότι η υποβολή φόρμας είναι νόμιμη.
Auth: Κλειδί API (κεφαλίδα X-Api-Key)
Request Body:
{"nonce": "nonce_xyz789"}Response:
{"valid": true, "verdict": "human", "score": 0.92, "timestamp": "2025-01-15T10:30:00Z"}Αυτό το endpoint μετράει στο όριό σας. Τα nonce είναι μίας χρήσης και λήγουν μετά από 5 λεπτά.