Strumenti per acquisire e convertire il Web

Client GrabzIt con Node.jsAPI Node.js

Descrizione

Questa classe gestisce tutte le comunicazioni con i servizi web di screenshot di GrabzIt.

Metodi pubblici

get_result (id)

Questo metodo restituisce lo screenshot stesso. Se non viene restituito nulla, qualcosa è andato storto o lo screenshot non è ancora pronto.

parametri

  • id - l'identificatore univoco dello screenshot
    • Obbligatorio

url_to_animation(Url, Opzioni)

Specifica l'URL del video online che dovrebbe essere convertito into GIF animata.

parametri

  • url: l'URL del video online da convertire into una GIF animata
    • Obbligatorio
    • Accetta URL video di Vimeo e YouTube
      • L'avvertimento dell'animazione di video Vimeo e YouTube dipende da una terza parte e pertanto potrebbe non fornire risultati coerenti.
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione della GIF animata.

Valore di ritorno

nulla

Opzioni di animazione

Tutte le opzioni disponibili durante la creazione di una GIF animata.

  • customId - identificativo personalizzato che è possibile passare al servizio web GIF animato. Questo verrà restituito con l'URL di callback che hai specificato.
    • Predefinito: vuoto
  • width - 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ò)
  • height - 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ò)
  • start - la posizione iniziale del video che dovrebbe essere convertito into GIF animata.
    • Predefinito: 0 secondi
  • duration - la lunghezza in secondi del video che dovrebbe essere convertito into GIF animata.
    • Predefinito: lunghezza massima per il pacchetto
  • speed - la velocità della GIF animata.
    • Predefinito: 1
    • Minimo: 0.2
    • Massimo: 10
  • framesPerSecond - il numero di fotogrammi al secondo che devono essere acquisiti dal video.
    • Predefinito: 10
    • Minimo: 0.2
    • Massimo: 60
  • repeat - numero di volte per eseguire il ciclo della GIF animata.
    • Predefinito: 0
    • Ciclo continuo: 0
  • reverse - se vero, i frame della GIF animata sono invertiti
    • Predefinito: falso
  • customWaterMarkId - aggiungi filigrana personalizzata alla GIF animata
    • Predefinito: vuoto
  • quality - il qualità dell'immagine restituita, che ha una compressione predefinita di 85%.
    • Ridurre la qualità ridurrà le dimensioni del file e i tempi di download.
    • Predefinito: -1
    • Minimo: -1
    • Massimo: 100
  • country - Paese la GIF animata dovrebbe essere presa da.
    • Avviso questa funzione è attualmente in versione beta e potrebbe non fornire risultati coerenti.
    • Predefinito: la posizione più veloce corrente
    • Opzioni: "SG", "UK", "US"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto

Esempio di opzioni

{
    'width':250,
    'height':250,
    'speed':2
}

url_to_image(Url, Opzioni)

Specifica l'URL che dovrebbe essere convertito into uno screenshot di immagine.

parametri

  • url: l'URL di cui dovrebbe essere fatto lo screenshot
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione dello screenshot.

Valore di ritorno

nulla

html_to_image(Html, Opzioni)

Specifica l'HTML che dovrebbe essere convertito into immagine.

parametri

  • html - l'HTML da convertire into immagine
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un'immagine.

Valore di ritorno

nulla

file_to_image(sentiero, Opzioni)

Specifica un file HTML che dovrebbe essere convertito into immagine.

parametri

  • percorso: il percorso del file di un file HTML da convertire into immagine
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un'immagine.

Valore di ritorno

nulla

Opzioni immagine

Tutte le opzioni disponibili durante la creazione di acquisizioni di immagini.

  • customId - identificativo personalizzato che è possibile passare al servizio web screenshot. Questo verrà restituito con l'URL di callback che hai specificato.
    • Predefinito: vuoto
  • browserWidth - la larghezza del browser in pixel
    • Predefinito: 1024
    • Massimo: 10000
  • browserHeight - 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)
  • 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)
  • height - l'altezza della miniatura risultante in mm
    • 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)
  • format - il formato in cui dovrebbe essere lo screenshot.
    • Predefinito: "jpg"
    • Opzioni: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
  • delay - il numero di millisecondi a attendere prima di fare lo screenshot
    • Predefinito: 0
    • Massimo: 30000
  • targetElement - il Selettore CSS dell'unico elemento HTML sulla pagina Web di destinazione che deve essere trasformato into screenshot, tutte le altre parti della pagina Web vengono ignorate. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo
    • Predefinito: vuoto
  • hideElement - 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
  • waitForElement - il Selettori CSS dell'elemento HTML nella pagina Web che deve essere visibile prima di eseguire l'acquisizione
    • Predefinito: vuoto
  • requestAs - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che deve essere utilizzato l'agente utente di un browser standard
      • 1 = indica che deve essere utilizzato l'agente utente di un browser mobile
      • 2 = indica che deve essere utilizzato l'agente utente di un motore di ricerca
      • 3 = indica che deve essere utilizzato l'agente utente di un browser di base
  • customWaterMarkId - aggiungi una filigrana personalizzata all'immagine
    • Predefinito: vuoto
  • quality - il qualità dell'immagine restituita. Questo attualmente ha effetto solo sulle immagini JPG, che ha una compressione predefinita di 85%.
    • Ridurre la qualità ridurrà le dimensioni del file e i tempi di download.
    • Predefinito: -1
    • Minimo: -1
    • Massimo: 100
  • transparent - se vero il l'acquisizione delle immagini dovrebbe essere trasparente. Questo è compatibile solo con immagini png e tiff.
    • Predefinito: falso
  • hd - se vera l'immagine la cattura sarà in alta definizione questo raddoppia la dimensione delle dimensioni dell'immagine.
    • Predefinito: falso
  • country - Paese lo screenshot 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"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • noAds - se è vero le pubblicità dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • noCookieNotifications - se vero, tutto ciò che si trova comunemente le notifiche dei cookie dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se viene utilizzato l'HTML da convertire URL relativi per risorse come CSS e immagini.
    • Predefinito: vuoto
  • post - definisce la query HTTP Poststring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL. L'uso di questa opzione forzerà GrabzIt a eseguire un post HTTP.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto

Esempio di opzioni

{
    'width':500,
    'height':500
}

url_to_rendered_html(Url, Opzioni)

Specifica l'URL che dovrebbe essere convertito into rendering HTML.

parametri

  • url: l'URL di cui deve essere composto l'HTML renderizzato
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione dell'HTML renderizzato.

Valore di ritorno

nulla

html_to_rendered_html(Html, Opzioni)

Specifica l'HTML che dovrebbe essere convertito into rendering HTML.

parametri

  • html - l'HTML da convertire into rendering HTML
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di HTML renderizzato.

Valore di ritorno

nulla

file_to_rendered_html(sentiero, Opzioni)

Specifica un file HTML che dovrebbe essere convertito into rendering HTML.

parametri

  • percorso: il percorso del file di un file HTML da convertire into rendering HTML
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di HTML renderizzato.

Valore di ritorno

nulla

Opzioni HTML

Tutte le opzioni disponibili quando creazione di acquisizioni HTML renderizzate.

  • customId - identificativo personalizzato che è possibile passare al servizio web. Questo verrà restituito con l'URL di callback che hai specificato.
    • Predefinito: vuoto
  • browserWidth - la larghezza del browser in pixel
    • Predefinito: 1024
    • Massimo: 10000
  • browserHeight - l'altezza del browser in pixel
    • Predefinito: 768
    • Massimo: 10000
  • delay - il numero di millisecondi a attendere prima di fare lo screenshot
    • Predefinito: 0
    • Massimo: 30000
  • waitForElement - il Selettori CSS dell'elemento HTML nella pagina Web che deve essere visibile prima di eseguire l'acquisizione
    • Predefinito: vuoto
  • requestAs - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che deve essere utilizzato l'agente utente di un browser standard
      • 1 = indica che deve essere utilizzato l'agente utente di un browser mobile
      • 2 = indica che deve essere utilizzato l'agente utente di un motore di ricerca
      • 3 = indica che deve essere utilizzato l'agente utente di un browser di base
  • country - Paese lo screenshot 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"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • noAds - se è vero le pubblicità dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • noCookieNotifications - se vero, tutto ciò che si trova comunemente le notifiche dei cookie dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se viene utilizzato l'HTML da convertire URL relativi per risorse come CSS e immagini.
    • Predefinito: vuoto
  • post - definisce la query HTTP Poststring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL. L'uso di questa opzione forzerà GrabzIt a eseguire un post HTTP.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto

Esempio di opzioni

{
    'country':'SG',
    'delay':5000
}

url_to_pdf(Url, Opzioni)

Specifica l'URL che dovrebbe essere convertito into PDF.

parametri

  • url: l'URL che deve essere convertito into PDF
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un PDF.

Valore di ritorno

nulla

html_to_pdf(Html, Opzioni)

Specifica l'HTML che dovrebbe essere convertito into PDF.

parametri

  • html - l'HTML da convertire into PDF
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un PDF.

Valore di ritorno

nulla

file_to_pdf(sentiero, Opzioni)

Specifica un file HTML che dovrebbe essere convertito into PDF.

parametri

  • percorso: il percorso del file di un file HTML da convertire into PDF
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un PDF.

Valore di ritorno

nulla

Opzioni PDF

Tutte le opzioni disponibili durante la creazione di acquisizioni PDF.

  • customId - un identificatore personalizzato che è possibile passare al servizio web. Questo verrà restituito con l'URL di callback che hai specificato.
    • Predefinito: vuoto
  • includeBackground - se vero, lo sfondo della pagina Web deve essere incluso nello screenshot
    • Predefinito: vero
  • pagesize - le dimensioni della pagina del PDF
    • Predefinito: "A4"
    • Opzioni: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legale", "Lettera"
  • orientation - l'orientamento del documento PDF
    • Predefinito: "Ritratto"
    • Opzioni: "Ritratto", "Paesaggio"
  • cssMediaType - il Tipo di supporto CSS del documento PDF
    • Predefinito: "Schermo"
    • Opzioni: "Schermo", "Print"
  • includeLinks - vero se i collegamenti devono essere inclusi nel PDF
    • Predefinito: vero
  • includeOutline - vero se Segnalibri PDF dovrebbe essere incluso
    • Predefinito: falso
  • title - fornire un titolo al documento PDF
    • Predefinito: vuoto
  • coverURL - l'URL di una pagina Web che dovrebbe essere utilizzata come copertina per il PDF
    • Predefinito: vuoto
  • marginTop - il margine in millimetri che dovrebbe apparire nella parte superiore della pagina del documento PDF
    • Predefinito: 10
  • marginLeft - il margine in millimetri che dovrebbe apparire a sinistra della pagina del documento PDF
    • Predefinito: 10
  • marginBottom - il margine in millimetri che dovrebbe apparire nella parte inferiore della pagina del documento PDF
    • Predefinito: 10
  • marginRight - il margine in millimetri che dovrebbe apparire alla destra del documento PDF
    • Predefinito: 10
  • browserWidth - il 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 la larghezza del browser corrisponde alla larghezza del documento PDF)
  • pageWidth - il larghezza personalizzata del PDF risultante in mm
  • pageHeight - il altezza personalizzata del PDF risultante in mm
  • delay - il numero di millisecondi a attendere prima di fare lo screenshot
    • Predefinito: 0
    • Massimo: 30000
  • requestAs - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che deve essere utilizzato l'agente utente di un browser standard
      • 1 = indica che deve essere utilizzato l'agente utente di un browser mobile
      • 2 = indica che deve essere utilizzato l'agente utente di un motore di ricerca
      • 3 = indica che deve essere utilizzato l'agente utente di un browser di base
  • templateId - aggiungere un modello ID che specifica l'intestazione e il piè di pagina del documento PDF
    • Predefinito: vuoto
  • targetElement - il Selettore CSS dell'unico Elemento HTML sulla pagina Web di destinazione che deve essere trasformato into PDF, tutte le altre parti della pagina Web vengono ignorate. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo
    • Predefinito: vuoto
  • hideElement - 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
  • waitForElement - il Selettori CSS dell'elemento HTML nella pagina Web che deve essere visibile prima di eseguire l'acquisizione
    • Predefinito: vuoto
  • customWaterMarkId - aggiungi una filigrana personalizzata a ciascuna pagina del documento PDF
    • Predefinito: vuoto
  • quality - il qualità del PDF restituito. L'impostazione predefinita utilizza la qualità consigliata per il PDF.
    • Ridurre la qualità ridurrà le dimensioni del file e i tempi di download.
    • Predefinito: -1
    • Minimo: -1
    • Massimo: 100
  • country - Paese lo screenshot 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"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • noAds - se è vero le pubblicità dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • noCookieNotifications - se vero, tutto ciò che si trova comunemente le notifiche dei cookie dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se viene utilizzato l'HTML da convertire URL relativi per risorse come CSS e immagini.
    • Predefinito: vuoto
  • post - definisce la query HTTP Poststring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL. L'uso di questa opzione forzerà GrabzIt a eseguire un post HTTP.
    • Predefinito: vuoto
  • templateVariables - definisce a modello personalizzato parametro e valore come querystring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto
  • mergeId - l'ID di una cattura che dovrebbe essere unito all'inizio del nuovo documento PDF
    • Predefinito: vuoto
  • password - il password per proteggere il documento PDF con i
    • Predefinito: vuoto

Esempio di opzioni

{
    'pagesize':'A5',
    'includeLinks':true
}

url_to_docx(Url, Opzioni)

Specifica l'URL che dovrebbe essere convertito into DOCX.

parametri

  • url: l'URL che deve essere convertito into DOCX
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un DOCX.

Valore di ritorno

nulla

html_to_docx(Html, Opzioni)

Specifica l'HTML che dovrebbe essere convertito into DOCX.

parametri

  • html - l'HTML da convertire into DOCX
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un DOCX.

Valore di ritorno

nulla

file_to_docx(sentiero, Opzioni)

Specifica un file HTML che dovrebbe essere convertito into DOCX.

parametri

  • percorso: il percorso del file di un file HTML da convertire into DOCX
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la creazione di un DOCX.

Valore di ritorno

nulla

Opzioni DOCX

Tutte le opzioni disponibili durante la creazione di acquisizioni DOCX.

  • customId - un identificatore personalizzato che è possibile passare al servizio web. Questo verrà restituito con l'URL di callback che hai specificato.
    • Predefinito: vuoto
  • includeBackground - se vero, le immagini di sfondo della pagina Web devono essere incluse nel DOCX
    • Predefinito: vero
  • pagesize - le dimensioni della pagina del DOCX
    • Predefinito: "A4"
    • Opzioni: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legale", "Lettera"
  • orientation - l'orientamento del documento DOCX
    • Predefinito: "Ritratto"
    • Opzioni: "Ritratto", "Paesaggio"
  • includeLinks - true se i collegamenti devono essere inclusi nel DOCX
    • Predefinito: vero
  • includeImages - se vero, le immagini della pagina Web devono essere incluse nel DOCX
    • Predefinito: vero
  • title - fornire un titolo al documento DOCX
    • Predefinito: vuoto
  • marginTop - il margine in millimetri che dovrebbe apparire nella parte superiore della pagina del documento DOCX
    • Predefinito: 10
  • marginLeft - il margine in millimetri che dovrebbe apparire a sinistra della pagina del documento DOCX
    • Predefinito: 10
  • marginBottom - il margine in millimetri che dovrebbe apparire nella parte inferiore della pagina del documento DOCX
    • Predefinito: 10
  • marginRight - il margine in millimetri che dovrebbe apparire alla destra del documento DOCX
    • Predefinito: 10
  • browserWidth - il 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 la larghezza del browser corrisponde alla larghezza del documento DOCX)
  • pageWidth - il larghezza personalizzata del DOCX risultante in mm
  • pageHeight - il altezza personalizzata del DOCX risultante in mm
  • delay - il numero di millisecondi a attendere prima di fare lo screenshot
    • Predefinito: 0
    • Massimo: 30000
  • requestAs - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che deve essere utilizzato l'agente utente di un browser standard
      • 1 = indica che deve essere utilizzato l'agente utente di un browser mobile
      • 2 = indica che deve essere utilizzato l'agente utente di un motore di ricerca
      • 3 = indica che deve essere utilizzato l'agente utente di un browser di base
  • templateId - aggiungere un modello ID che specifica l'intestazione e il piè di pagina del documento DOCX
    • Predefinito: vuoto
  • targetElement - il Selettore CSS dell'unico elemento HTML sulla pagina Web di destinazione che deve essere trasformato into DOCX, tutte le altre parti della pagina Web vengono ignorate. Se sono presenti più elementi HTML corrispondenti, viene scelto il primo
    • Predefinito: vuoto
  • hideElement - 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
  • waitForElement - il Selettori CSS dell'elemento HTML nella pagina Web che deve essere visibile prima di eseguire l'acquisizione
    • Predefinito: vuoto
  • quality - il qualità del DOCX restituito. La qualità predefinita delle immagini in DOCX è 85%.
    • Ridurre la qualità ridurrà le dimensioni del file e i tempi di download.
    • Predefinito: -1
    • Minimo: -1
    • Massimo: 100
  • country - Paese lo screenshot 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"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • noAds - se è vero le pubblicità dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • noCookieNotifications - se vero, tutto ciò che si trova comunemente le notifiche dei cookie dovrebbero essere nascoste automaticamente.
    • Predefinito: falso
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se viene utilizzato l'HTML da convertire URL relativi per risorse come CSS e immagini.
    • Predefinito: vuoto
  • post - definisce la query HTTP Poststring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL. L'uso di questa opzione forzerà GrabzIt a eseguire un post HTTP.
    • Predefinito: vuoto
  • templateVariables - definisce a modello personalizzato parametro e valore come querystring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto
  • mergeId - l'ID di una cattura che dovrebbe essere unito all'inizio del nuovo documento DOCX
    • Predefinito: vuoto
  • password - il password per proteggere il documento DOCX con i
    • Predefinito: vuoto

Esempio di opzioni

{
    'pagesize':'A5',
    'includeLinks':true
}

url_to_table(Url, Opzioni)

Specifica l'URL da cui devono essere estratte le tabelle HTML.

parametri

  • url - l'URL da cui estrarre le tabelle HTML
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la conversione della tabella HTML.

Valore di ritorno

nulla

html_to_table(Html, Opzioni)

Specifica l'HTML da cui devono essere estratte le tabelle HTML.

parametri

  • html - l'HTML da cui estrarre le tabelle HTML.
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la conversione della tabella HTML.

Valore di ritorno

nulla

file_to_table(sentiero, Opzioni)

Specifica un file HTML da cui estrarre le tabelle HTML.

parametri

  • percorso: il percorso del file di un file HTML da cui estrarre le tabelle HTML.
    • Obbligatorio
  • Opzioni - un oggetto JSON che definisce eventuali opzioni speciali da utilizzare durante la conversione della tabella HTML.

Valore di ritorno

nulla

Opzioni tabella

Tutte le opzioni disponibili durante la conversione di tabelle HTML in CSV, XLSX o JSON.

  • customId - un identificatore personalizzato che è possibile passare al servizio web. Questo verrà restituito con l'URL di callback che hai specificato
    • Predefinito: vuoto
  • tableNumberToInclude - 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
  • format - il formato in cui deve essere la tabella
    • Predefinito: "csv"
    • Opzioni: "csv", "json", "xlsx"
  • includeHeaderNames - se nella tabella saranno inclusi i nomi di intestazioni vere
    • Predefinito: vero
  • 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: falso
  • targetElement - l'id dell'unico elemento HTML nella pagina Web da cui utilizzare per estrarre le tabelle
    • Predefinito: vuoto
  • requestAs - il tipo di agente utente che si desidera utilizzare
    • Predefinito: 0
    • Opzioni:
      • 0 = indica che deve essere utilizzato l'agente utente di un browser standard
      • 1 = indica che deve essere utilizzato l'agente utente di un browser mobile
      • 2 = indica che deve essere utilizzato l'agente utente di un motore di ricerca
      • 3 = indica che deve essere utilizzato l'agente utente di un browser di base
  • country - Paese lo screenshot 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"
  • exportURL - il URL di esportazione che specifica dove esportare anche l'acquisizione
    • Predefinito: vuoto
  • encryptionKey - se viene specificata una chiave di crittografia AES con codifica 64 di base, la tua acquisizione viene crittografata quando viene creata. Si consiglia di utilizzare il creare il metodo della chiave di crittografia per creare la chiave e il decodificare i metodi per decrittografare l'acquisizione crittografata come mostrato in questo esempio.
    • Predefinito: vuoto
  • post - definisce la query HTTP Poststring. Ogni nome e valore nella querystring dovrà essere codificato nell'URL. L'uso di questa opzione forzerà GrabzIt a eseguire un post HTTP.
    • Predefinito: vuoto
  • address - l'URL in cui eseguire il codice HTML. Può essere utile se viene utilizzato l'HTML da convertire URL relativi per risorse come CSS e immagini.
    • Predefinito: vuoto
  • proxy - i dettagli del proxy HTTP il software del browser dovrebbe utilizzare per creare questa acquisizione
    • Predefinito: vuoto

Esempio di opzioni

{
    'format':'xlsx',
    'includeHeaderNames':true
}

L'uso dell'opzione callBackUrl è il metodo consigliato per salvare un file

save(callBackUrl, incompleto)

Save il risultato in modo asincrono e restituisce un identificatore univoco, che può essere utilizzato per ottenere lo screenshot con il get_result metodo.

parametri

  • callBackURL - il Handler il servizio GrabzIt dovrebbe chiamare dopo aver completato il suo lavoro
  • oncomplete (error, id) - la funzione di callback, che viene chiamata quando viene recuperato l'id dello screenshot.

save_to(saveToFile, incompleto)

Save il risultato in modo sincrono senza utilizzare un URL di richiamata.

parametri

  • saveToFile: sarà il percorso del file da acquisire saveda una volta che è stato completato
  • oncomplete (errore, dati) - la funzione di callback, che viene chiamata quando lo screenshot è stato scaricato. Il parametro data contiene i byte delle schermate.

get_status(id, incompleto)

Ottieni lo stato corrente di uno screenshot di GrabzIt.

parametri

  • id - l'identificatore univoco dello screenshot
    • Obbligatorio
  • onComplete (errore, status) - la funzione di callback, che viene chiamata quando lo stato dello screenshot è stato recuperato.
    • Obbligatorio

get_cookies(dominio, incompleto)

Ricevi tutti i cookie che GrabzIt utilizza per un determinato dominio. Ciò può includere anche i cookie definiti dall'utente.

parametri

  • dominio - il dominio per cui restituire i cookie
    • Obbligatorio
  • onComplete (errore, biscotti) - la funzione di richiamata, che viene chiamata quando i cookie sono stati recuperati.
    • Obbligatorio

set_cookie (nome, dominio, opzioni, incompleto)

Imposta un nuovo cookie personalizzato su GrabzIt, se il cookie personalizzato ha lo stesso nome e dominio di un cookie globale, il cookie globale viene sovrascritto.

Ciò può essere utile se la funzionalità di un sito Web è controllata dai cookie.

parametri

  • nome: il nome del cookie da impostare
    • Obbligatorio
  • dominio - il dominio del sito Web per cui impostare il cookie
    • Obbligatorio
  • Opzioni
    • valore - il valore del cookie
    • percorso: il percorso del sito Web a cui si riferisce il cookie
    • httponly - se vero, il cookie può essere utilizzato solo con il protocollo HTTP
    • scade: definisce quando scade il cookie. Passa un valore nullo se il cookie non deve scadere
    {
        'value':'me@example.com',
        'httponly':false
    }
    
  • oncomplete (errore, successo) - la funzione di callback, che viene chiamata quando il cookie è stato impostato. Il parametro success è true se il cookie è impostato correttamente, altrimenti false

delete_cookie (nome, dominio, incompleto)

Elimina un cookie personalizzato o blocca l'utilizzo di un cookie globale

parametri

  • nome: il nome del cookie da eliminare
    • Obbligatorio
  • dominio - il dominio del sito Web per cui eliminare il cookie
    • Obbligatorio
  • oncomplete (errore, successo) - la funzione di callback, che viene chiamata quando il cookie è stato impostato. Il parametro successo è vero se il cookie viene eliminato, altrimenti falso.

get_watermarks ()

Ottieni tutte le filigrane personalizzate caricate

parametri

  • onComplete (errore, filigrane) - la funzione di callback, che viene chiamata quando le filigrane sono state recuperate. Il parametro watermark contiene una matrice di filigrane.
    • Obbligatorio

get_watermark (identificatore, incompleto)

Restituisce la filigrana personalizzata che corrisponde all'identificatore specificato

parametri

  • identificatore: l'identificatore di una particolare filigrana personalizzata che si desidera visualizzare
    • Obbligatorio
  • onComplete (errore, filigrane) - la funzione di callback, che viene chiamata quando la filigrana è stata recuperata. Il parametro watermark contiene un array di filigrane.
    • Obbligatorio

add_watermark (identificatore, percorso, xpos, ypos, incompleto)

Aggiungi una nuova filigrana personalizzata

parametri

  • identificatore: l'identificatore che si desidera assegnare alla filigrana personalizzata. È importante che questo identificatore sia univoco.
    • Obbligatorio
  • percorso: il percorso assoluto della filigrana sul server. Ad esempio C: /watermark/1.png
    • Obbligatorio
  • xpos - la posizione orizzontale in cui vuoi che appaia lo screenshot
    • Obbligatorio
    • Opzioni:
      • Sinistra = 0
      • Centro = 1
      • Destra = 2
  • ypos - posizione verticale in cui vuoi che appaia lo screenshot
    • Obbligatorio
    • Opzioni:
      • Superiore = 0
      • Medio = 1
      • In basso = 2
  • oncomplete (errore, esito positivo): la funzione di callback, che viene chiamata quando è stata aggiunta la filigrana. Il parametro success è true se la filigrana è stata aggiunta correttamente, altrimenti false.
    • Obbligatorio

delete_watermark (identificatore, incompleto)

Elimina una filigrana personalizzata

parametri

  • identificatore: l'identificatore della filigrana personalizzata che si desidera eliminare
    • Obbligatorio
  • oncomplete (errore, esito positivo): la funzione di callback, che viene chiamata quando la filigrana è stata rimossa. Il parametro success è true se la filigrana è stata eliminata correttamente.
    • Obbligatorio

set_local_proxy (valore)

Questo metodo consente a server proxy locale da utilizzare per tutte le richieste.

parametri

  • valore: l'URL, che può includere una porta, se necessario, del proxy. Fornire un valore null rimuoverà qualsiasi proxy precedentemente impostato
    • Obbligatorio

use_ssl (valore)

Specifica se le richieste a GrabzIt's L'API dovrebbe usare SSL

parametri

  • valore - se vero tutte le richieste all'API di GrabzIt utilizzeranno SSL
    • Obbligatorio

create_encryption_key ()

Crea una chiave di crittografia 64 di base crittograficamente sicura, lunga 44 caratteri.


decifrare (dati, chiave)

Decifrare un'acquisizione crittografata utilizzando la chiave di crittografia fornita.

parametri

  • percorso: il percorso dell'acquisizione crittografata
    • Obbligatorio
  • chiave - il chiave di crittografia
    • Obbligatorio

decrypt_file (percorso, chiave, incompleto)

Decifrare un'acquisizione crittografata utilizzando la chiave di crittografia fornita.

parametri

  • percorso: il percorso dell'acquisizione crittografata
    • Obbligatorio
  • chiave - il chiave di crittografia
    • Obbligatorio
  • oncomplete (errore) - la funzione di callback, che viene chiamata quando il file viene decrittografato.

Classi di risultati

Cookie

Variabili pubbliche

  • name - il nome del cookie
  • valore - il valore del cookie
  • dominio: il dominio per cui è impostato il cookie
  • percorso: il percorso sul dominio a cui si applica questo cookie.
  • httponly - se questo cookie è valido solo quando il sito Web viene visualizzato con il protocollo HTTP.
  • scade - la data di scadenza di questo cookie
  • tipo - il tipo di cookie che è
    • Opzioni:
      • Globale: questo è un cookie globale impostato da GrabzIt
      • Locale: questo è un cookie locale impostato da te
      • Sostituito: un cookie globale che è stato sovrascritto da te

Stato

La classe che rappresenta lo stato corrente dello screenshot.

Variabili pubbliche

  • elaborazione - se vero lo screenshot è ancora in fase di elaborazione.
  • cache: se vero lo screenshot è stato elaborato ed è attualmente memorizzato nella cache.
  • scaduto - se vero lo screenshot non è più sul sistema GrabzIt.
  • messaggio: un messaggio di errore restituito dal sistema.

WaterMark

Questa classe rappresenta le filigrane personalizzate archiviate in GrabzIt

Variabili pubbliche

  • identificatore: l'identificatore della filigrana
  • formato: il formato dell'immagine della filigrana
  • xPosition: la posizione x in cui appare la filigrana sullo screenshot
    • Opzioni:
      • Sinistra = 0
      • Centro = 1
      • Destra = 2
  • yPosition: la posizione y in cui appare la filigrana sullo screenshot
    • Opzioni:
      • Superiore = 0
      • Medio = 1
      • In basso = 2