Skip to main content

​
Per iniziare

Scraping sincrono

L’endpoint scrape esegue una sessione del browser e restituisce HTML renderizzato in una singola richiesta — ideale per integrazioni a bassa latenza.

Job asincroni

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

​
Architettura REST

L’API di web scraping 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.

​
Versioni dell’API

L’API di web scraping mantiene la compatibilità all’indietro tramite versionamento ed è attualmente alla Versione 1.

​
Autenticazione

La chiave API è l’unica credenziale per accedere all’API di web scraping. Ogni servizio Cleariflow richiede una chiave univoca. Includete la chiave nel corpo JSON come api_key.

​
URL base

​
Rendering delle pagine

Le pagine vengono renderizzate in un vero browser headless. JavaScript viene eseguito completamente prima di restituire i contenuti. La protezione SSRF integrata blocca le richieste a localhost e alle reti IP private.

​
Codici di risposta ed errore

In caso di errore, l’API restituisce risposte JSON strutturate con codici e descrizioni specifiche per una risoluzione efficace dei problemi.