Documentação

Tudo o que você precisa para integrar o MeltDocs.

Introdução

O MeltDocs converte e manipula documentos por uma API HTTP simples. Envie seus arquivos como multipart/form-data e receba o resultado de volta — converta arquivos Office, HTML, URLs e Markdown para PDF, capture screenshots e junte ou divida PDFs, tudo atrás de um único token.

A URL base da API é https://api.meltdocs.com. Toda rota é um POST e retorna um arquivo.

Autenticação

Autentique toda requisição com seu token de API como Bearer token. Crie uma conta grátis, abra seu painel e copie seu token (começa com mdk_).

Authorization: Bearer mdk_live_…

Este cabeçalho é obrigatório em todas as rotas abaixo. Mantenha seu token em segredo e regenere-o pelo painel se ele vazar. Cada conversão bem-sucedida conta como uma unidade na sua quota mensal.

Documentos Office → PDF

Converta Word, Excel, PowerPoint, OpenDocument e mais para PDF. Envie o documento no campo files.

curl https://api.meltdocs.com/forms/libreoffice/convert \
  -H "Authorization: Bearer mdk_live_…" \
  -F files=@relatorio.docx \
  -o relatorio.pdf

Opções comuns (enviadas como campos de formulário):

Envie vários files para converter um lote de uma vez; eles voltam como ZIP, a menos que você use merge=true para uni-los em um único PDF.

HTML, URL & Markdown → PDF

Renderize conteúdo web em PDFs precisos.

A partir de uma URL

curl https://api.meltdocs.com/forms/chromium/convert/url \
  -H "Authorization: Bearer mdk_live_…" \
  -F url=https://example.com \
  -o pagina.pdf

A partir de um arquivo HTML

curl https://api.meltdocs.com/forms/chromium/convert/html \
  -H "Authorization: Bearer mdk_live_…" \
  -F files=@index.html \
  -o pagina.pdf

Markdown funciona da mesma forma em /forms/chromium/convert/markdown. Opções de layout incluem paperWidth, paperHeight, marginTop/Bottom/Left/Right, landscape, printBackground, scale e waitDelay (para a página assentar antes da captura).

Ferramentas de PDF

Juntar

curl https://api.meltdocs.com/forms/pdfengines/merge \
  -H "Authorization: Bearer mdk_live_…" \
  -F files=@a.pdf \
  -F files=@b.pdf \
  -o juntado.pdf

Dividir

POST /forms/pdfengines/split — divide um PDF por intervalos de páginas. Defina splitMode (intervals ou pages) e splitSpan (ex.: 2).

Converter para PDF/A

POST /forms/pdfengines/convert com pdfa (ex.: PDF/A-3b) ou pdfua=true.

Screenshots

Capture uma URL ou página HTML como imagem (PNG, JPEG ou WebP) via /forms/chromium/screenshot/url, /html ou /markdown.

curl https://api.meltdocs.com/forms/chromium/screenshot/url \
  -H "Authorization: Bearer mdk_live_…" \
  -F url=https://example.com \
  -F format=png \
  -o shot.png

Quotas & limites

Cada plano inclui uma quota mensal de conversões que renova no primeiro dia de cada mês (UTC). Seu painel mostra o uso em relação à quota em tempo real. Ao atingir o limite, as requisições retornam 402 Payment Required até a quota renovar ou você fazer upgrade na página de preços.

Erros