FAQ - Perguntas Frequentes | PreviewFile.dev

Perguntas comuns sobre recursos, preços, segurança e implementação técnica do PreviewFile.dev.

PreviewFile.dev é um serviço seguro de visualização de arquivos que gera links de visualização personalizáveis e de curta duração para 110+ formatos de arquivo. Compartilhe PDFs, documentos Office, imagens, vídeos e mais sem expor URLs originais ou exigir downloads.

→ Saiba mais em Começando

Quais formatos de arquivo são suportados?

Suportamos 110+ formatos incluindo:

Documentos: PDF, DOCX, PPTX, XLSX, TXT, MD
Imagens: JPG, PNG, GIF, WebP, SVG, TIFF
Vídeos: MP4, WebM, MOV, AVI
Código: JS, Python, Java, Go e 50+ linguagens
Arquivos: ZIP, RAR, 7z, TAR

→ Veja lista completa em Formatos Suportados

Como funciona o preço?

Gratuito: 100 visualizações/mês, TTL de 15 minutos
Pro: 10.000 visualizações/mês, marcas d'água personalizadas, TTL de 24 horas
Equipe: 100.000 visualizações/mês, marca branca, SSO
Empresa: Ilimitado, SLA, suporte dedicado

→ Compare planos em Preços

Perguntas Técnicas

Como gero um link de visualização?

Use a API REST para criar links de visualização programaticamente:

curl -X POST https://previewfile.dev/api/u \
  -H "x-api-key: $API_KEY" \
  -d '{"url": "https://example.com/file.pdf", "ttlMinutes": 60}'

→ Guia completo em Documentação da API

Vocês armazenam meus arquivos?

Não. Apenas armazenamos em cache metadados e miniaturas.

→ Leia sobre nossa arquitetura em Políticas de Segurança

Posso usar isso para documentos sensíveis?

Sim. Habilite estes recursos de segurança:

Links com tempo limitado: Auto-expiração de 5 minutos a 24 horas
Marcas d'água: Adicionar overlays de texto personalizados
Modo sem download: Prevenir downloads de arquivos
Links de uso único: Expirar após primeiro acesso

→ Explore todas as opções em Políticas de Segurança

O que acontece quando um link expira?

Links expirados mostram uma página de erro "Link Expirado". Metadados de visualização são automaticamente excluídos do nosso banco de dados, e quaisquer miniaturas em cache são removidas dentro de 1 hora.

Posso incorporar visualizações na minha app?

Sim. Use <iframe> com a URL de visualização:

<iframe src="https://previewfile.dev/p/abc123" 
        width="100%" height="600px"></iframe>

Planos de equipe suportam listas brancas de domínio para restringir onde incorporações funcionam.

→ Detalhes da API em Documentação da API

Perguntas de Segurança

Minha URL original é exposta?

Não. Destinatários veem apenas a URL curta de visualização (ex. previewfile.dev/p/abc123). A URL original do arquivo nunca é visível no navegador ou logs de rede.

Como funcionam as marcas d'água?

Marcas d'água são renderizadas do lado do cliente usando overlays Canvas/GPU. Você pode personalizar texto, posicionamento e opacidade. Planos de equipe suportam fontes e logos personalizados.

→ Guia de configuração em Políticas de Segurança

Posso restringir acesso por IP ou referrer?

Sim (planos Equipe+). Configure:

Lista branca de IP: Apenas permitir IPs específicos
Restrições de referrer: Bloquear hotlinking
Validação de User-Agent: Prevenir scraping automatizado

→ Controles avançados em Políticas de Segurança

Vocês são compatíveis com GDPR/HIPAA?

Planos Enterprise incluem:

Acordos de processamento de dados (DPA)
Logs de auditoria para todos os eventos de acesso
Opções de residência de dados regional
Certificação SOC 2 Type II

Contate vendas para documentação de conformidade.

Perguntas do Produto

Qual a diferença entre Free e Pro?

Recurso	Free	Pro
Visualizações mensais	100	10.000
TTL máximo	15 minutos	24 horas
Marcas d'água personalizadas	❌	✅
Controle de download	✅	✅
Links de uso único	✅	✅

→ Comparação completa em Preços

Posso personalizar as páginas de visualização?

Sim (planos Equipe+). Personalize:

Domínio personalizado (preview.yourdomain.com)
Cabeçalho/rodapé com marca
Temas CSS personalizados
Remover rodapé "Powered by PreviewFile"

Contate vendas para configuração de marca branca.

Vocês oferecem limitação de taxa da API?

Sim. Limites de taxa por plano:

Gratuito: 100 solicitações/hora
Pro: 1.000 solicitações/hora
Equipe: 10.000 solicitações/hora
Empresa: Limites personalizados

Limites excedidos retornam HTTP 429 com cabeçalho Retry-After.

→ Referência da API em Documentação da API

Posso obter análises de uso?

Sim. Dashboard mostra:

Total de visualizações geradas
Arquivos mais visualizados
Distribuição geográfica
Divisão por formato
Padrões de expiração

Planos de equipe incluem exportação CSV e notificações webhook.

Perguntas de Integração

Quais linguagens vocês suportam?

Fornecemos exemplos para:

JavaScript/Node.js, Python, Java, C#, Go
Rust, PHP, Ruby, Swift, Kotlin

→ Exemplos de código em Documentação da API

Posso usar isso com AWS S3 / Google Cloud?

Sim. Gere URLs assinadas do seu provedor de armazenamento, depois passe para PreviewFile:

const s3Url = await getSignedUrl(s3Client, getObjectCommand);
const preview = await fetch('/api/u', {
  body: JSON.stringify({ url: s3Url })
});

Certifique-se de que URLs assinadas sejam válidas por mais tempo que seu TTL de visualização.

Vocês têm SDKs?

SDKs oficiais em breve. Atualmente use clientes HTTP padrão com a API REST.

→ Solicitar SDK em GitHub Discussions

Posso hospedar isso eu mesmo?

Planos Enterprise incluem opções de implantação on-premise com manifestos Docker/Kubernetes. Contate vendas para licenciamento.

Solução de Problemas

Por que minha visualização mostra "Formato Não Suportado"?

Verifique se a extensão do arquivo corresponde ao tipo MIME
Verifique se o formato está em Formatos Suportados
Certifique-se de que a URL original seja publicamente acessível
Tente re-enviar com o tipo MIME correto

Link de visualização retorna 404

Causas comuns:

Link expirado (verifique timestamp expireAt)
Link de uso único já acessado
URL curta inválida (verifique erros de digitação)

Visualização de vídeo/áudio não funciona

Certifique-se:

Arquivo está em codec suportado (H.264/AAC recomendado)
Servidor de origem envia cabeçalho Content-Type correto
Cabeçalhos CORS permitem acesso cross-origin
Tamanho do arquivo < 500 MB para performance ótima

→ Reportar problemas em GitHub Issues

Cartões de crédito/débito (Visa, Mastercard, Amex)
PayPal (planos Equipe+)
Fatura/ACH (apenas Enterprise)

Vocês oferecem descontos para organizações sem fins lucrativos?

Sim. Organizações sem fins lucrativos e instituições educacionais recebem 50% de desconto em planos Pro/Equipe. Contate vendas com prova de status.

Ainda tem perguntas?

📧 Email: [email protected]
💬 Discord: Junte-se à nossa comunidade
🐦 Twitter: @previewfile
📖 Documentação: Navegar todas as docs

FAQ - Perguntas Frequentes

Perguntas Gerais

O que é PreviewFile.dev?