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)
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ção | Tipo | Descrição |
|---|---|---|
max | string ou number | Obrigatória. Mesmo formato de data-pdfkind-max: 5MB, 500KB ou bytes. |
el | Element | Opcional. 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:
| reason | Significado |
|---|---|
too-big | Mesmo reduzido, o arquivo passa do limite. |
unsupported | Não é um PDF nem uma imagem que o assistente consiga reduzir. |
cancel | O visitante fechou a janela. |
unavailable | A janela do PDFkind não carregou em até 8 segundos. |
timeout | O processamento levou mais de 3 minutos. |
failed | O arquivo está corrompido, ou algo mais deu errado. |
bad-call | Chamada 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.
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