PDFkind
Documentação para desenvolvedores: API JavaScript

Assistente de upload

API JavaScript

Reduza um PDF ou uma imagem até um limite de tamanho a partir do seu próprio código com PDFkind.fit(file, { max }) e trate cada resultado possível.

O script adiciona um objeto global PDFkind. Use-o quando os arquivos vêm de um lugar que o modo automático não enxerga: colagem, câmera, um seletor personalizado.

PDFkind.fit(file, options)

JavaScript
try {
  const small = await PDFkind.fit(file, { max: '5MB' });
  upload(small);
} catch (err) {
  if (err.reason === 'too-big') alert('Este arquivo é grande demais, mesmo reduzido.');
  else upload(file);   // usa o arquivo original como alternativa
}
OpçãoTipoDescrição
maxstring ou numberObrigatória. Mesmo formato de data-pdfkind-max: 5MB, 500KB ou bytes.
elElementOpcional. O data-lang dele (ou de um elemento pai) define o idioma da janela.

Ela resolve com um File: o arquivo reduzido, o JPG convertido no caso de fotos HEIC ou o original quando ele já está dentro do limite (nesse caso, nenhuma janela abre). Ela rejeita com um erro cujo reason é um destes:

reasonSignificado
too-bigMesmo reduzido, o arquivo passa do limite.
unsupportedNão é um PDF nem uma imagem que o assistente consiga reduzir.
cancelO visitante fechou a janela.
unavailableA janela do PDFkind não carregou em até 8 segundos.
timeoutO processamento levou mais de 3 minutos.
failedO arquivo está corrompido, ou algo mais deu errado.
bad-callChamada sem um File ou sem max.

PDFkind.mount(root)

Transforma os elementos data-pdfkind-tool em ferramentas. Roda sozinho no carregamento da página; chame de novo depois de adicionar ferramentas mais tarde, por exemplo em uma single-page app. root é opcional e, por padrão, é a página inteira.

JavaScript
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);

PDFkind.version

A versão do script, atualmente 3. Útil para conferir se o script carregou: digite PDFkind.version no console do navegador.

Atualizado em 3 de novembro de 2026 · Dúvidas: contact@pdfkind.com