Faça capturas de tela de sites com nossa API RESTful Screenshot

A API REST do GrabzIt permite capturar URLs ou HTML inteiramente usando técnicas RESTful. Antes de começar, leia as seguintes advertências com atenção, dependendo do seu caso de uso. Uma de nossas outras soluções de API talvez seja mais adequada.

- Alguns recursos, como mesclar e criptografar capturas, não estão disponíveis nesta API REST. Para usar esses recursos, você precisará usar outro Biblioteca de API
- Não use essa API no lado do cliente, pois ela exporá sua chave de aplicativo! Em vez disso, use o API JavaScript

Para começar, selecione o que você deseja fazer no filtro abaixo e os parâmetros disponíveis serão exibidos junto com um exemplo básico.

O que você quer fazer?

Ao fazer solicitações, verifique todos os Os valores dos parâmetros são codificados em URL.

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

Ao converter HTML, todos os parâmetros devem ser publicado no corpo da solicitação como pares chave-valor. Certifique-se de que todos os valores de parâmetro sejam codificados por URL e o tipo de conteúdo seja application / x-www-form-urlencoded.

    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

A captura será então retornada na resposta HTTP. As seguintes opções adicionais também estão disponíveis com este tipo de captura, todas opcionais, exceto aquelas marcadas como obrigatórias. Ao testar a funcionalidade da API, recomendamos usar Postman para simplificar o processo.

url - o URL da captura.
- Exigido
html - o HTML para o convertido.
- Exigido
- Ao converter HTML, você deve usar um HTTP POST.
chave - seu Chave do aplicativo.
- Exigido
ligue de volta - o URL do manipulador GrabzIt deve chamar depois de concluir seu trabalho.
- Descubra como criar um manipulador, seguindo a documentação para cada idioma ASP.NET, Java, Node.js, Perl, PHP, Python e Ruby.
id personalizado - o identificador personalizado que você pode associar à captura.
- Isso será retornado com qualquer URL de retorno que você especificou.
formato - o formato em que a captura deve estar.
- Padrão: jpg
- opções:
  - bmp8
  - bmp16
  - bmp24
  - bmp
  - csv
  - gif
  - html
  - jpg
  - json
  - pdf
  - docx
  - png
  - seo
  - arrufo
  - mp4
  - webp
  - XLSX
address - o URL para executar o código HTML. Pode ser útil se o HTML que está sendo convertido usa URLs relativos a recursos como CSS e imagens.
- Padrão: vazio
background - se verdadeiro, o plano de fundo da página da web deve ser incluído no PDF
- Padrão: 1
- opções:
  - 0 = indica que o documento PDF não deve incluir o plano de fundo da página da web
  - 1 = indica que o documento PDF deve incluir o plano de fundo da página da web
background - se verdadeiro, as imagens de fundo da página da web devem ser incluídas no DOCX
- Padrão: 1
- opções:
  - 0 = indica que o documento DOCX não deve incluir as imagens de plano de fundo da página da web
  - 1 = indica que o documento DOCX deve incluir as imagens de plano de fundo da página da web
bwidth - a largura do navegador em pixels
- Aviso: este recurso está atualmente na versão beta e pode não fornecer resultados consistentes.
- Padrão: 1366
- Máximo: 10000
- Largura automática: -1 (passando -1 significa que o largura do navegador coincide com a largura do documento)
bheight - a altura do navegador em pixels.
- Padrão: 1170
- Máximo: 10000
- Comprimento total: -1 (passar -1 significa que é feita uma captura de tela de toda a página da web)
click - especifica o elemento HTML, usando um Seletor CSS clicar. Lembre-se de que também pode ser necessário um atraso para ver os efeitos do clique
- Aviso: este recurso está atualmente na versão beta e pode não fornecer resultados consistentes.
country - o país a captura de tela / captura deve ser retirada.
- Padrão: o local mais rápido atual
- Opções: "SG", "Reino Unido", "EUA"
coverurl - o URL de uma página da web que deve ser usada como uma página de rosto para o PDF
- Padrão: vazio
customwatermarkid - adicione um personalizadas watermark para o arquivo
- Padrão: vazio
delay - o número de milissegundos a aguarde antes de tirar a captura de tela
- Padrão: 0
- Máximo: 30000
duração - a duração em segundos do vídeo que deve ser convertido intum GIF animado.
- Padrão: comprimento máximo para o pacote
duração - the length in seconds of the web page should be recorded for.
- Padrão: comprimento máximo para o pacote
export - a URL de exportação que especifica onde a captura também deve ser exportada.
fps - the number of frames per second that should be captured.
- Padrão: 10
- Mínimo: 0.2
- Máximo: 60
hd - se verdadeira a imagem captura estará em alta definição isso dobra o tamanho das dimensões da imagem.
- Padrão: 0
- opções:
  - 0 = criar uma imagem de alta definição
  - 1 = criar uma imagem de alta definição
height - a altura da miniatura resultante em pixels
- Padrão: se a largura e a altura de saída não forem especificadas ou 0, a largura e altura de saída corresponderão à largura e altura da imagem final; se a largura de saída for especificada, a altura de saída será proporcional à largura de saída
- Máximo: Altura máxima para o pacote
- Altura total: -1 (passar -1 significa que a altura da miniatura não é reduzida)
height - a altura personalizada do documento resultante em mm
- Padrão: tamanho da página altura
- Mínimo: 15
altura - a altura do GIF animado resultante em pixels.
- Padrão: 120px
- Máximo: Altura máxima para o pacote
- Tamanho automático: -1 (passar -1 significa que a altura do GIF animado é redimensionado em relação à sua largura, se a altura estiver sendo dimensionada automaticamente, a largura não poderá)
hide - a Seletores CSS dos um ou mais elementos HTML na página da web a serem ocultados, para especificar vários elementos HTML a serem ocultados separadamente cada seletor com uma vírgula.
- Padrão: vazio
includealltables - se true, toda a tabela na página da Web será extraída, com cada tabela aparecendo em uma planilha separada.
- Disponível apenas no formato XLSX
- Padrão: 0
- opções:
  - 0 = indica que todas as tabelas não serão extraídas
  - 1 = indica que todas as tabelas serão extraídas
includeheadernames - se nomes de cabeçalho verdadeiros serão incluídos na tabela
- Padrão: 1
- opções:
  - 0 = indica que os nomes dos cabeçalhos não serão incluídos na tabela
  - 1 = indica que os nomes dos cabeçalhos serão incluídos na tabela
includeimages - se verdadeiro, as imagens da página da web devem ser incluídas no DOCX
- Padrão: 1
- opções:
  - 0 = indica que o documento DOCX não incluirá imagens da página da web
  - 1 = indica que o documento DOCX incluirá imagens da página da web
includelinks - true se os links devem ser incluídos no documento
- Padrão: 1
- opções:
  - 0 = indica que o documento não deve incluir links
  - 1 = indica que o documento deve incluir links
includeoutline - verdadeiro se Favoritos em PDF Deveria ser incluído
- Padrão: 0
- opções:
  - 0 = indica que o documento PDF não incluirá um esboço
  - 1 = indica que o documento PDF incluirá um esboço
mergeid - adicione o ID de uma captura que deve ser mesclado no início do novo documento
- Padrão: vazio
mtop - a margem em milímetros que deve aparecer na parte superior da página do documento
- Padrão: 10
mleft - a margem em milímetros que deve aparecer à esquerda da página do documento
- Padrão: 10
mbottom - a margem em milímetros que deve aparecer na parte inferior da página do documento
- Padrão: 10
mright - a margem em milímetros que deve aparecer à direita do documento PDF
- Padrão: 10
media - a Tipo de mídia CSS do documento PDF
- Padrão: Print
- opções:
  - Print
  - tela
noads - se for verdade anúncios devem ser ocultados automaticamente.
- Padrão: 0
- opções:
  - 0 = exibir anúncios
  - 1 = ocultar anúncios
nonotify - se verdadeiro, todos comumente encontrados as notificações de cookies devem ser ocultadas automaticamente.
- Padrão: 0
- opções:
  - 0 = exibir notificações de cookies
  - 1 = ocultar notificações de cookies
orientation - a orientação do documento
- Padrão: Retrato
- opções:
  - Retrato
  - Paisagem
pagesize - o tamanho da página do documento
- Padrão: A4
- opções:
  - A3
  - A4
  - A5
  - A6
  - B3
  - B4
  - B5
  - B6
  - Legal
  - Carta
password - a senha para proteger o documento com
- Padrão: vazio
proxy - os detalhes do proxy HTTP o software do navegador deve usar para criar essa captura
post - quaisquer parâmetros de postagem que você deseja enviar.
quality - a qualidade da captura, JPG e WEBP têm uma compressão padrão de 90% e GIF 85%. Este parâmetro não tem efeito em imagens BMP, PNG ou TIFF.
- Reduzir a qualidade reduzirá o tamanho do arquivo e reduzirá o tempo de download.
- Padrão: -1
- Mínimo: -1
- Máximo: 100
repetir - número de vezes para repetir o GIF animado.
- Padrão: 0
- Loop continuamente: 0
- Nunca Loop: -1
reverso - se verdadeiro, os quadros do GIF animado são revertidos
- Padrão: 0
- opções:
  - 0 = indica que a animação não será reverenciada
  - 1 = indica que a animação será revertida
requestas - o tipo de agente do usuário que você deseja usar
- Padrão: 0
- opções:
  - 0 = indica que a versão padrão do site deve ser devolvida
  - 1 = indica o versão móvel de um site deve ser retornado
  - 2 = indica que a visualização do mecanismo de pesquisa de um site deve ser retornada
velocidade - a velocidade do GIF animado.
- Padrão: 1
- Mínimo: 0.2
- Máximo: 10
começo - a posição inicial do vídeo que deve ser convertida intum GIF animado.
- Padrão: 0 segundos
tabletoinclude - o índice da tabela a ser convertida, onde todas as tabelas em uma página da web são ordenadas da parte superior da página para a parte inferior
- Padrão: 1
target - este parâmetro especifica o Seletor CSS do único elemento HTML na página da web de destino a ser ativada into documento, todas as outras partes da página da web são ignoradas. Se houver vários elementos HTML correspondentes, o primeiro será escolhido.
- Padrão: vazio
target - este parâmetro especifica o Seletor CSS do único elemento HTML na página da web de destino a ser ativada intoa imagem, todas as outras partes da página da web são ignoradas. Se houver vários elementos HTML correspondentes, o primeiro será escolhido.
- Padrão: vazio
target - o ID do único elemento HTML na página da web que deve ser usado para extrair tabelas de
- Padrão: vazio
transparent - se verdadeiro, o a captura de imagem deve ser transparente. Isso é compatível apenas com imagens png e tiff.
- Padrão: 0
- opções:
  - 0 = criar uma imagem não transparente
  - 1 = criar uma imagem transparente
templateid - adicione um modelo ID que especifica o cabeçalho e rodapé do documento
- Padrão: vazio
title - forneça um título para o documento PDF
- Padrão: vazio
waitfor - especifica o elemento HTML, usando um Seletor CSS. Uma vez que o elemento é visível a captura é executada. Se houver vários elementos HTML correspondentes, o primeiro será escolhido. Quando esse parâmetro é usado, ele aguarda no máximo XN XNX segundos antes da captura ser realizada.
width - a largura da miniatura resultante em pixels
- Padrão: se a largura e a altura de saída não forem especificadas ou 0, a largura e altura de saída corresponderão à largura e altura da imagem final, se a altura de saída for especificada, a largura de saída será proporcional à altura de saída
- Máximo: Largura máxima para o pacote
- Largura total: -1 (passar -1 significa que a largura da miniatura não é reduzida)
width - a largura personalizada do documento resultante em mm
- Padrão: tamanho da página largura
- Mínimo: 15
largura - a largura do GIF animado resultante em pixels.
- Padrão: 180px
- Máximo: Largura máxima para o pacote
- Tamanho automático: -1 (passar -1 significa que a largura do GIF animado é redimensionado em relação à sua altura, se a largura estiver sendo dimensionada automaticamente, a altura não poderá)

Tratamento de erros

Se houver algum problema com a solicitação que você fez à API, um objeto JSON será retornado explicando o erro. A melhor maneira de determinar isso é verificar o tipo de conteúdo da resposta antes do processamento, se for application/json ocorreu um erro. O código de erro encontrado no JSON segue o lista padrão de códigos.

{
    "Result": false,
    "Code":"URL is missing",
    "Message":100
}