Skip to main content

​
Per iniziare

Screenshot sincrono

L’endpoint screenshot esegue una sessione del browser e restituisce un’immagine codificata in base64 in JSON — ideale per integrazioni programmatiche e l’API Tester.

Job asincroni

Gli endpoint jobs accodano attività di screenshot e permettono di verificare stato e risultati — ideali per alto volume o pagine lente.

​
Architettura REST

L’API screenshot di siti web segue i principi REST, con URL prevedibili orientati alle risorse e codici di stato HTTP standard per un’integrazione fluida e la gestione degli errori.

​
Sicurezza HTTPS

Tutte le comunicazioni API sono protette con TLS 1.2 o superiore per garantire integrità e privacy dei dati.

​
Versioning API

L’API screenshot di siti web mantiene la retrocompatibilità tramite versioning e attualmente opera in Version 1.

​
Autenticazione

La chiave API è l’unica credenziale per accedere all’API screenshot di siti web. Ogni servizio Cleariflow richiede una chiave univoca. Includi la chiave nel corpo JSON come api_key, o come parametro query per l’endpoint GET legacy.

​
URL base

​
Rendering delle pagine

Le pagine vengono renderizzate in un browser headless reale. JavaScript viene eseguito completamente prima della cattura dello screenshot. La protezione SSRF integrata blocca le richieste a localhost e intervalli IP privati.

​
Codici di risposta ed errore

Quando le richieste falliscono, l’API restituisce risposte di errore JSON strutturate con codici e descrizioni specifici per una risoluzione efficace dei problemi.