Plataforma FileConvertFree para Programadores

Integre conversão de ficheiros na sua aplicação

Use a API REST do FileConvertFree para converter PDFs e imagens a partir da sua aplicação, backend, automação, fluxo empresarial ou sistema de escritório.

API v1: A documentação é pública. Os pedidos à API exigem uma conta FileConvertFree com Premium ou Pro ativo.

Abrir painel Ver planos Documentação interativa da API

URL base

REST API v1

https://fileconvertfree.com/api1

Autenticação

X-API-Key header

X-API-Key: fcf_live_••••••••

Início rápido

Inicie sessão na sua conta FileConvertFree.

Use um plano Premium ou Pro ativo.

Abra Painel → API para Programadores → Criar chave API. Guarde a chave completa imediatamente, pois é mostrada apenas uma vez.

Envie a chave no cabeçalho X-API-Key em cada pedido protegido à API.

Planos e limites da API

Os limites são partilhados por toda a conta e por todas as chaves API. Criar mais chaves não aumenta a quota.

Premium

200 / day

200 Pedidos diários
30 Pedidos / minuto
200 MB Tamanho máximo do ficheiro
3 Chaves ativas max

Pro

400 / day

400 Pedidos diários
60 Pedidos / minuto
200 MB Tamanho máximo do ficheiro
3 Chaves ativas max

Gestão de chaves API

1. Criar uma chave

No Painel, use a secção API para Programadores. Pode manter até 3 chaves API ativas. Dê a cada chave um nome útil, como Produção, Aplicação de Escritório ou Staging.

2. Guarde-a uma vez

O segredo completo é mostrado apenas após a criação ou regeneração. O FileConvertFree guarda um hash seguro, não o segredo em texto simples, por isso a chave completa não pode ser mostrada mais tarde.

3. Regenerar uma chave

A regeneração cria um novo segredo e revoga imediatamente a chave antiga. Atualize a sua aplicação e guarde o novo segredo antes de fechar a janela que o mostra uma única vez.

4. Revogar uma chave

Revogue uma chave se já não for necessária ou puder ter sido exposta. Ela deixa de autenticar imediatamente. O registo de uma chave revogada é eliminado automaticamente após 7 dias.

Regras de segurança

Nunca partilhe uma chave API, publique-a no GitHub, coloque-a em JavaScript executado no navegador, envie-a em capturas de ecrã ou a guarde em código público. Use variáveis de ambiente do servidor ou um gestor de segredos. Se suspeitar de comprometimento, regenere ou revogue a chave imediatamente.

Endpoints disponíveis

Método	Endpoint	Finalidade / opções
GET	`/v1/account/usage`	Consultar plano autenticado, estado da chave, utilização diária, quota restante e utilização do limite de pedidos.
GET	`/health`	Verificação pública do estado e da versão da API.
POST	`/v1/pdf/to-word`	Converter um PDF válido para Word.
POST	`/v1/pdf/to-excel`	Converter um PDF válido para Excel.
POST	`/v1/image/to-text`	Extrair texto OCR de uma imagem. Campo multipart opcional: fast=true\|false.
POST	`/v1/image/to-word`	Converter uma imagem para Word. Campo multipart opcional: fast=true\|false.
POST	`/v1/image/to-excel`	Converter uma imagem para Excel. Campo multipart opcional: fast=true\|false.
POST	`/v1/image/remove-background`	Remover o fundo de uma imagem. Campos opcionais: format (padrão png), transparent=true\|false, fast_mode=true\|false.

Exemplos de código

import os import requests API_KEY = os.environ["FCF_API_KEY"] url = "https://fileconvertfree.com/api1/v1/pdf/to-word" with open("sample.pdf", "rb") as source: response = requests.post( url, headers={"X-API-Key": API_KEY}, files={"file": ("sample.pdf", source, "application/pdf")}, timeout=700, ) response.raise_for_status() with open("converted.docx", "wb") as out: out.write(response.content)

import { readFile, writeFile } from "node:fs/promises"; const key = process.env.FCF_API_KEY; const bytes = await readFile("scan.png"); const form = new FormData(); form.append("file", new Blob([bytes], { type: "image/png" }), "scan.png"); form.append("fast", "false"); const response = await fetch( "https://fileconvertfree.com/api1/v1/image/to-text", { method: "POST", headers: { "X-API-Key": key }, body: form } ); if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`); console.log(await response.json());

Use o exemplo JavaScript num servidor/ambiente Node.js. Nunca exponha a chave secreta em JavaScript do frontend ou do navegador.

curl -X POST "https://fileconvertfree.com/api1/v1/pdf/to-excel" \ -H "X-API-Key: $FCF_API_KEY" \ -F "file=@sample.pdf" \ --output converted.xlsx

<?php $apiKey = getenv('FCF_API_KEY'); $ch = curl_init('https://fileconvertfree.com/api1/v1/image/to-word'); $file = new CURLFile(__DIR__ . '/scan.png', 'image/png', 'scan.png'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['X-API-Key: ' . $apiKey], CURLOPT_POSTFIELDS => ['file' => $file, 'fast' => 'false'], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 700, ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); if ($body === false || $status >= 400) { throw new RuntimeException('API request failed: HTTP ' . $status); } file_put_contents(__DIR__ . '/converted.docx', $body); curl_close($ch);

Ficheiros aceites e validação

Os endpoints de PDF aceitam ficheiros PDF reais. Os endpoints de imagem aceitam JPEG/JPG/JFIF, PNG, WebP, GIF, BMP e TIFF/TIF. A API verifica a extensão e a assinatura real do ficheiro; renomear um ficheiro não suportado não contorna a validação.

Comportamento das respostas

Os endpoints de conversão devolvem diretamente ao cliente o corpo do ficheiro convertido. Image-to-text devolve JSON. URLs internas de download dos conversores não são expostas aos clientes da API.

Erros HTTP e significado

Estado	Significado	Motivo típico / ação
401	Chave API ausente, inválida, expirada ou revogada.	Verifique X-API-Key. Se a chave foi revogada ou regenerada, substitua-a pelo segredo atual.
403	O acesso à API não está ativo.	A conta não tem atualmente um plano Premium ou Pro ativo.
409	A ação da chave entra em conflito com o estado atual.	Exemplos: tentar criar mais de 3 chaves ativas ou regenerar uma chave que não está ativa.
413	O ficheiro enviado é demasiado grande.	Use um ficheiro dentro do limite do plano API (atualmente 200 MB).
415	Tipo de ficheiro não suportado ou incompatível.	Use um PDF/imagem suportado e mantenha a extensão correta; a API também valida a assinatura do ficheiro.
422	Conteúdo do pedido inválido.	O ficheiro pode estar vazio ou os dados multipart obrigatórios podem estar ausentes ou inválidos.
429	Demasiados pedidos.	Atingiu o limite por minuto ou a quota diária da conta. Tente novamente mais tarde ou aguarde a reposição diária.
5xx	Falha temporária da API ou do serviço de conversão.	Tente novamente com atraso progressivo. Falhas de infraestrutura/backend não são cobradas na quota diária.

Como a quota é contabilizada

A quota diária e o limite por minuto são partilhados por todas as chaves da mesma conta API. Envios inválidos ou não suportados rejeitados antes da conversão não consomem a quota diária. Falhas do servidor ou infraestrutura devolvem a quota reservada. Um pedido aceite para conversão pode contar mesmo que o conversor posterior devolva um erro 4xx do cliente. A quota diária é reposta segundo o dia de calendário do servidor/base de dados da API.

Usage check: GET https://fileconvertfree.com/api1/v1/account/usage

Perguntas frequentes

Uma conta Free pode usar a API?

Não. A documentação é pública, mas o acesso à API exige atualmente um plano Premium ou Pro ativo.

Criar 3 chaves triplica a quota?

Não. Todas as chaves partilham os limites diários e por minuto da mesma conta.

Posso recuperar um segredo perdido?

Não. A chave em texto simples não é guardada. Regenere a chave e guarde o novo segredo.

O que acontece quando o plano pago expira?

O acesso à API é desativado quando a conta do site deixa de ter um plano elegível ativo. Renove Premium ou Pro para restaurar o acesso.

Pronto para integrar o FileConvertFree?

Crie a chave no Painel, teste-a no endpoint de utilização e depois ligue a rota de conversão de que a sua aplicação necessita.

Abrir painel Documentação interativa da API