Convert File FastAPI
A gente construiu uma API que recebe um arquivo e devolve ele convertido na mesma resposta. Esta página não é a venda dela — é o relato do problema que nos levou a escrever isso.
Um parágrafo factual, para ninguém precisar adivinhar do que estamos falando.
O Convert File Fast é uma API. Um sistema envia um arquivo por requisição e recebe de volta o arquivo convertido na resposta da mesma chamada, sem fila para consultar depois. São mais de sessenta tipos de conversão entre documentos, planilhas, apresentações, imagens e PDFs, incluindo o caminho de volta. Não existe tela de conversão para o usuário final: ela é chamada de dentro de um processo que já roda.
Endpoints, exemplos de código, limites por plano e preço ficam no site do produto: convertfilefast.com. É lá que ele é vendido. Aqui embaixo é a nossa versão da história.
E o ponto era sempre o mesmo: alguém abrindo um arquivo só para salvar em outro formato.
Isso apareceu primeiro no nosso próprio trabalho de automação, dentro da operação de clientes. Montávamos um fluxo que ia do começo ao fim sozinho e ele empacava num passo bobo: o sistema seguinte não lê o formato que o anterior gerou. Cada episódio isolado é rápido; o que pesa é a frequência com que ele volta, todo dia.
A saída que tentamos primeiro foi a que todo mundo tenta: instalar um pacote de escritório no servidor e chamá-lo por linha de comando. Funciona por um tempo. Depois vem a atualização que muda o layout, o processo que trava segurando um arquivo, o volume de fechamento de mês que derruba a máquina. A partir daí converter arquivo virou mais uma infraestrutura para manter de pé.
E existe o custo silencioso do erro de conversão. Quando a fonte se perde ou a tabela quebra, o documento chega errado no cliente. O retrabalho não é converter de novo — é a ligação explicando por que o contrato saiu com a cláusula fora do lugar. Foi olhando para isso que decidimos escrever o nosso.
Todas reduziram o público possível. Foi intencional, e vale explicar por quê.
A maior parte dos conversores é um site onde alguém arrasta o arquivo e baixa o resultado. Isso não resolvia o nosso problema: se alguém precisa arrastar, alguém continua sendo o passo manual. Então não construímos essa tela para o usuário final. Existe endpoint, chave e chamada de dentro do fluxo. O custo é evidente — quem só quer converter um arquivo avulso não é nosso caso, e preferimos dizer isso a fingir que serve.
O caminho tradicional para conversão é assíncrono: a API aceita, devolve um identificador e você consulta depois. É mais fácil de escalar. Escolhemos o síncrono porque o passo do formato costuma estar no meio de um fluxo, e um fluxo que fica consultando volta a ter estado para gerenciar — a complexidade que a automação existia para eliminar. A maioria dos arquivos volta em menos de dois segundos; os maiores ou mais complexos levam mais.
Guardar o arquivo convertido teria sido útil: daria cache e reprocessamento. Decidimos não guardar o conteúdo — ele é processado em memória e descartado quando a conversão termina. Fica o registro da chamada: nome do arquivo, tamanho, IP e navegador de origem, que é o que alimenta o histórico no painel. Abrimos mão do resto porque o que se converte ali é documento de cliente, e não existir cópia encurta muito a conversa com o jurídico de quem contrata.
Um limite declarado vale mais do que um superlativo, ainda mais quando o teste custa uma requisição.
Mais de sessenta tipos de conversão, com preservação de formatação, fonte, imagem e layout — a parte que decide se o documento segue direto para o cliente ou precisa de conferência humana. Vários arquivos podem ser convertidos numa única requisição, o que resolve o lote que chega junto no fechamento. O plano gratuito dá dez conversões por mês, com limite de cinco megabytes por arquivo, e não pede cartão.
Continua não existindo tela de conversão para o usuário final. O único arrastar de arquivo que existe é no testador da documentação, que já exige chave. O tamanho máximo de arquivo também é limitado por plano.
O painel lista as últimas conversões e o uso dos últimos trinta dias, mas o que ele guarda é o registro da chamada, não o arquivo. Não existe reprocessamento do que já foi enviado — se o seu processo precisa reabrir uma conversão de três meses atrás, quem guarda o arquivo é você.
Convert File Fast nasceu dentro da Sincron IA, o mesmo time que faz automação de processos na operação de clientes. Quando o gargalo é maior do que uma ferramenta resolve, o caminho é a etapa de discovery.
A documentação, os endpoints e o plano gratuito estão no site dele. Este texto foi só para explicar por que ele existe.
