Acquisisci screenshot del sito web con la nostra API RESTful Screenshot

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.

Che cosa vuoi fare?

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.
- Scopri come creare un gestore seguendo la documentazione per ogni lingua ASP.NET, Java, Node.js, Perl, PHP, Python ed Rubino.
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
- Predefinito: dimensioni della pagina altezza
- Minimo: 15
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
- Predefinito: dimensioni della pagina larghezza
- Minimo: 15
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ò)