Strumenti per acquisire e convertire il Web

Acquisisci screenshot del sito web con la nostra API RESTful ScreenshotAPI REST

L'API REST di GrabzIt ti permette di catturare URL o HTML interamente usando tecniche RESTful. Prima di iniziare, leggi attentamente le seguenti avvertenze, a seconda del tuo caso d'uso, una delle nostre altre soluzioni API potrebbe essere più adatta.

  • - Alcune funzionalità come l'unione e la crittografia delle acquisizioni non sono disponibili tramite questa API REST. Per utilizzare queste funzionalità dovrai utilizzarne un'altra Libreria API
  • - Non utilizzare questa API sul lato client, esporrà la chiave dell'applicazione! Invece usa il API JavaScript

Per iniziare, seleziona cosa vuoi fare dal filtro in basso e i parametri disponibili verranno visualizzati insieme a un esempio di base.

Quando si effettua una richiesta, assicurarsi tutti i i valori dei parametri sono codificati nell'URL.

    https://api.grabz.it/services/convert.ashx?key=Sign in to view your Application Key&format=&url=https%3A%2F%2Fspacex.com%2F

Quando si converte HTML, tutti i parametri devono essere pubblicato nel corpo della richiesta come coppie chiave-valore. Assicurarsi che tutti i valori dei parametri siano codificati nell'URL.

    curl 
    -d key=Sign in to view your Application Key 
    -d format= 
    -d html=%3Ch1%3EConvert%20Me%21%3C%2Fh1%3E 
    https://api.grabz.it/services/convert.ashx    

Le seguenti opzioni aggiuntive sono disponibili con questo tipo di acquisizione, tutte facoltative ad eccezione di quelle contrassegnate come obbligatorie. Durante il test della funzionalità API si consiglia di utilizzare Postino per semplificare il processo.

  • URL - l'URL dell'acquisizione.
    • Obbligatorio
  • html - l'HTML da convertire.
    • Obbligatorio
    • Quando si converte HTML è necessario utilizzare un HTTP POST.
  • chiave - il tuo Chiave dell'applicazione.
    • Obbligatorio
  • richiama - l'URL del gestore che GrabzIt dovrebbe chiamare dopo che ha completato il suo lavoro.
  • customid - l'identificatore personalizzato che puoi associare all'acquisizione.
    • Questo verrà restituito con qualsiasi URL di callback che hai specificato.
  • formato - il formato in cui dovrebbe essere l'acquisizione.
    • Predefinito: jpg
    • Opzioni:
      • bmp8
      • bmp16
      • bmp24
      • bmp
      • csv
        • I file CSV vengono scaricati automaticamente.
      • gif
      • html
        • I file HTML vengono scaricati automaticamente.
      • jpg
      • json
        • I file JSON vengono scaricati automaticamente.
      • pdf
        • I file PDF vengono scaricati automaticamente.
      • docx
        • I file DOCX vengono scaricati automaticamente.
      • png
      • tiff
      • WebP
      • xlsx
        • I file XLSX vengono scaricati automaticamente.
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se l'HTML da convertire utilizza URL relativi a risorse come CSS e immagini.
    • Predefinito: vuoto
  • background - se vero, lo sfondo della pagina Web deve essere incluso nel PDF
    • Predefinito: 1
    • Opzioni:
      • 0 = indica che il documento PDF non deve includere lo sfondo della pagina Web
      • 1 = indica che il documento PDF deve includere lo sfondo della pagina Web
  • background - se vero, le immagini di sfondo della pagina Web devono essere incluse nel DOCX
    • Predefinito: 1
    • Opzioni:
      • 0 = indica che il documento DOCX non deve includere le immagini di sfondo della pagina Web
      • 1 = indica che il documento DOCX dovrebbe includere le immagini di sfondo della pagina web
  • bwidth - la larghezza del browser in pixel
    • Avviso questa funzione è attualmente in versione beta e potrebbe non fornire risultati coerenti.
    • Predefinito: 1024
    • Massimo: 10000
    • Larghezza automatica: -1 (passando -1 significa che il larghezza del browser corrisponde alla larghezza del documento)
  • bheight - l'altezza del browser in pixel.
    • Predefinito: 768
    • Massimo: 10000
    • Lunghezza totale: -1 (passando -1 significa che viene presa una sequenza dell'intera pagina Web)
  • country - Paese lo screenshot / acquisizione dovrebbe essere preso da.
    • Avviso questa funzione è attualmente in versione beta e potrebbe non fornire risultati coerenti.
    • Predefinito: la posizione più veloce corrente
    • Opzioni: "SG", "UK", "US"
  • coverurl - l'URL di una pagina Web che dovrebbe essere utilizzata come copertina per il PDF
    • Predefinito: vuoto
  • customwatermarkid - aggiungere un filigrana personalizzata al file
    • Predefinito: vuoto
  • delay - il numero di millisecondi a attendere prima di fare lo screenshot
    • Predefinito: 0
    • Massimo: 30000
  • durata - la lunghezza in secondi del video che dovrebbe essere convertito into GIF animata.
    • Predefinito: lunghezza massima per il pacchetto
  • export - il URL di esportazione che specifica dove esportare anche l'acquisizione.
  • filename - sovrascrive il nome file del file scaricato
    • Valido solo dove viene scaricato lo screenshot / acquisizione
    • Predefinito: vuoto
  • fps - il numero di fotogrammi al secondo che devono essere acquisiti dal video.
    • Predefinito: 10
    • Minimo: 0.2
    • Massimo: 60
  • hd - se vera l'immagine la cattura sarà in alta definizione questo raddoppia la dimensione delle dimensioni dell'immagine.
    • Predefinito: 0
    • Opzioni:
      • 0 = crea un'immagine ad alta definizione
      • 1 = crea un'immagine ad alta definizione
  • height - l'altezza della miniatura risultante in pixel
    • Predefinito: il rapporto più alto possibile dell'altezza del browser che si adatta all'altezza massima per il pacchetto degli utenti
    • Massimo: altezza massima per pacchetto
    • Altezza totale: -1 (passando -1 significa che l'altezza della miniatura non viene ridotta)
  • height - il altezza personalizzata del documento risultante in mm
  • altezza - l'altezza della GIF animata risultante in pixel.
    • Predefinito: 120px
    • Massimo: altezza massima per pacchetto
    • Dimensione automatica: -1 (passando -1 significa che l'altezza di la GIF animata viene ridimensionata in relazione alla sua larghezza, se l'altezza viene ridimensionata automaticamente la larghezza non può)
  • hide - il Selettori CSS di uno o più elementi HTML nella pagina Web da nascondere, per specificare più elementi HTML da nascondere separatamente ogni selettore con una virgola.
    • Predefinito: vuoto
  • includealltables - se vero, tutta la tabella della pagina Web verrà estratta con ciascuna tabella visualizzata in un foglio di calcolo separato.
    • Disponibile solo con il formato XLSX
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che tutte le tabelle non verranno estratte
      • 1 = indica che verranno estratte tutte le tabelle
  • includeheadernames - se nella tabella saranno inclusi i nomi di intestazioni vere
    • Predefinito: 1
    • Opzioni:
      • 0 = indica che i nomi delle intestazioni non verranno inclusi nella tabella
      • 1 = indica che i nomi delle intestazioni verranno inclusi nella tabella
  • includeimages - se vero, le immagini della pagina Web devono essere incluse nel DOCX
    • Predefinito: 1
    • Opzioni:
      • 0 = indica che il documento DOCX non includerà le immagini delle pagine Web
      • 1 = indica che il documento DOCX includerà immagini di pagine Web
  • includelinks - true se i collegamenti devono essere inclusi nel documento
    • Predefinito: 1
    • Opzioni:
      • 0 = indica che il documento non deve includere collegamenti
      • 1 = indica che il documento deve includere i collegamenti
  • includeoutline - vero se Segnalibri PDF dovrebbe essere incluso
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che il documento PDF non includerà uno schema
      • 1 = indica che il documento PDF includerà una struttura
  • mergeid - aggiungi l'ID di un'acquisizione che dovrebbe essere unito all'inizio del nuovo documento
    • Predefinito: vuoto
  • mtop - il margine in millimetri che dovrebbe apparire nella parte superiore della pagina del documento
    • Predefinito: 10
  • mleft - il margine in millimetri che dovrebbe apparire a sinistra della pagina del documento
    • Predefinito: 10
  • mbottom - il margine in millimetri che dovrebbe apparire nella parte inferiore della pagina del documento
    • Predefinito: 10
  • mright - il margine in millimetri che dovrebbe apparire alla destra del documento PDF
    • Predefinito: 10
  • media - il Tipo di supporto CSS del documento PDF
    • Predefinito: Print
    • Opzioni:
      • Stampa
      • Schermo
  • noads - se è vero le pubblicità dovrebbero essere nascoste automaticamente.
    • Predefinito: 0
    • Opzioni:
      • 0 = mostra annunci
      • 1 = nascondi annunci
  • nonotify - se vero, tutto ciò che si trova comunemente le notifiche dei cookie dovrebbero essere nascoste automaticamente.
    • Predefinito: 0
    • Opzioni:
      • 0 = mostra le notifiche sui cookie
      • 1 = nascondi le notifiche sui cookie
  • orientation - l'orientamento del documento
    • Predefinito: Ritratto
    • Opzioni:
      • Ritratto
      • Paesaggio
  • pagesize - le dimensioni della pagina del documento
    • Predefinito: A4
    • Opzioni:
      • A3
      • A4
      • A5
      • A6
      • B3
      • B4
      • B5
      • B6
      • Area legale
      • Lettera
  • password - il password per proteggere il documento con i
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
  • post - eventuali parametri di post che si desidera inviare.
  • quality - il qualità della cattura, JPG e GIF hanno una compressione predefinita di 85% e WEBP 80%. Questo parametro non ha alcun effetto sulle immagini BMP, PNG o TIFF.
    • Ridurre la qualità ridurrà le dimensioni del file e i tempi di download.
    • Predefinito: -1
    • Minimo: -1
    • Massimo: 100
  • ripetere - numero di volte per eseguire il ciclo della GIF animata.
    • Predefinito: 0
    • Ciclo continuo: 0
  • invertire - se vero, i frame della GIF animata sono invertiti
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che l'animazione non verrà riverita
      • 1 = indica che l'animazione verrà invertita
  • requestas - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che è necessario restituire la versione standard del sito Web
      • 1 = indica il versione mobile di un sito Web deve essere restituito
      • 2 = indica che la visualizzazione del motore di ricerca di un sito Web deve essere restituita
      • 3 = indica che la versione di fallback di un sito Web deve essere restituita utilizzando un programma utente di un browser di base
  • velocità - la velocità della GIF animata.
    • Predefinito: 1
    • Minimo: 0.2
    • Massimo: 10
  • inizia a - la posizione iniziale del video che dovrebbe essere convertito into GIF animata.
    • Predefinito: 0 secondi
  • tabletoinclude - l'indice della tabella da convertire, dove tutte le tabelle di una pagina Web sono ordinate dalla parte superiore della pagina Web verso il basso
    • Predefinito: 1
  • target - questo parametro specifica il Selettore CSS dell'unico elemento HTML sulla pagina Web di destinazione che deve essere trasformato into un documento, tutte le altre parti della pagina Web vengono ignorate. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo.
    • Predefinito: vuoto
  • target - questo parametro specifica il Selettore CSS dell'unico Elemento HTML sulla pagina Web di destinazione che deve essere trasformata into immagine, tutte le altre parti della pagina Web vengono ignorate. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo.
    • Predefinito: vuoto
  • target - l'id dell'unico elemento HTML nella pagina Web da cui utilizzare per estrarre le tabelle
    • Predefinito: vuoto
  • transparent - se vero il l'acquisizione delle immagini dovrebbe essere trasparente. Questo è compatibile solo con immagini png e tiff.
    • Predefinito: 0
    • Opzioni:
      • 0 = crea un'immagine non trasparente
      • 1 = crea un'immagine trasparente
  • templateid - aggiungere un modello ID che specifica l'intestazione e il piè di pagina del documento
    • Predefinito: vuoto
  • title - fornire un titolo al documento PDF
    • Predefinito: vuoto
  • waitfor - questo specifica l'elemento HTML, utilizzando un file Selettore CSS. Una volta che l'elemento è visibile viene eseguita la cattura. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo. Quando viene utilizzato questo parametro, attenderà un massimo di 25 secondi prima che venga eseguita la cattura.
  • width - la larghezza della miniatura risultante in pixel
    • Predefinito: il rapporto più alto possibile tra la larghezza del browser e la larghezza massima per il pacchetto degli utenti
    • Massima: larghezza massima per pacchetto
    • Larghezza intera: -1 (passando -1 significa che la larghezza della miniatura non viene ridotta)
  • width - il larghezza personalizzata del documento risultante in mm
  • larghezza - la larghezza della GIF animata risultante in pixel.
    • Predefinito: 180px
    • Massima: larghezza massima per pacchetto
    • Dimensione automatica: -1 (passando -1 significa che la larghezza di la GIF animata viene ridimensionata in relazione alla sua altezza, se la larghezza viene ridimensionata automaticamente, l'altezza non può)