MarkupGo API de template para imagem e PDF Oferta Lifetime

Perguntas frequentes — MarkupGo API de template para imagem e PDF

O que é o MarkupGo e para quais casos ele é indicado?

O MarkupGo é uma API/plataforma que gera imagens e PDFs a partir de HTML, URLs, Markdown ou templates reutilizáveis (HTML/CSS/JS). É ideal para automações que exigem produção em escala e padronização visual: thumbnails, criativos para anúncios, capas, certificados, invoices, relatórios e outros documentos onde velocidade, consistência e automação importam.

Como funciona o Magic Template URL e quais cuidados de segurança devo tomar?

O Magic Template URL permite gerar uma imagem ou PDF apenas acessando uma URL com parâmetros na query string. Cada URL única consome 1 crédito na primeira geração; reutilizações da mesma URL pelos próximos 15 dias são servidas do cache sem custo adicional. Atenção: a URL é pública — quem tiver acesso pode gerar/baixar o arquivo. Boas práticas: gere/consuma a URL server‑side quando possível, use json=true para receber um task/JSON (em vez do binário direto) e não exponha templates com dados sensíveis; para controle de acesso total, gere via API autenticada.

Como são cobrados os créditos, existe cache e como dimensionar para produção?

Cada geração única (task via API ou URL única) consome créditos na primeira execução. O cache evita custo repetido para a mesma URL por até 15 dias. Para controlar custo e dimensionar: use templates reutilizáveis, prefira passar variações por parâmetros em vez de criar templates novos, aplique Image Transformation para variações de formato/ratio e agrupe gerações em batches quando fizer sentido. Meça renders médios, estime a taxa de cache hit e inicie com um piloto para ajustar projeções com dados reais (analytics ajudam nesse dimensionamento).

Quais transformações de imagem e formatos eu consigo aplicar direto pela URL ou API?

A Image Transformation API permite ajustar tamanho (width/height/fit), aplicar blur, brilho/contraste, sharpen, rotacionar, trim e sobrepor elementos (ex.: watermark/logo). Suporta formatos como PNG, JPEG e WebP. Tudo é controlado por parâmetros (query string ou options), o que facilita gerar variações para diferentes plataformas (feed, story, etc.) sem reprocessar os templates no servidor.

Como funciona a geração de PDF e quais recursos profissionais ela oferece?

A engine de PDF é pixel‑perfect: renderiza SVGs e emojis corretamente, permite cabeçalho/rodapé, controle de margens, inclusão de metadados e opção PDF/UA para acessibilidade. Dá controle fino sobre layout e qualidade, sendo apropriada para relatórios, propostas, invoices e documentos que exigem precisão visual e conformidade.

Como integro o MarkupGo em aplicações (Node, serverless, n8n) na prática?

Há um SDK oficial para Node com métodos como image/pdf.fromTemplate, fromUrl, fromHtml e fromMarkdown. As chamadas podem retornar JSON (task) ou buffer. Use buffer para downloads diretos; use json=true e rode a lógica server‑side (Cloud Functions, Next.js APIs, Workers) ao embutir em apps; e integre com ferramentas de automação (n8n, Make) via requisições HTTP ou Magic URL para montar fluxos sem infraestrutura própria.

O Office→PDF (beta) atende minhas necessidades? Quais são as limitações conhecidas?

Sim — o Office→PDF converte 130+ formatos (docx, xlsx, pptx etc.) e permite mesclar arquivos, útil para unificar propostas, relatórios e anexos. Como está em beta, há limites: até 5 MB por arquivo e até 10 arquivos por requisição. Recomenda‑se pré‑testar com seus arquivos reais, compactar grandes anexos e criar um fluxo de tratamento (pré‑processamento) antes de automatizar em larga escala.