Piattaforma FileConvertFree per sviluppatori

Integra la conversione dei file nella tua applicazione

Usa la REST API di FileConvertFree per convertire PDF e immagini dalla tua applicazione, backend, automazione, flusso di lavoro aziendale o sistema d’ufficio.

API v1: La documentazione è pubblica. Le richieste API richiedono un account FileConvertFree Premium o Pro attivo.

Apri pannello Vedi piani Documentazione API interattiva

URL base

REST API v1

https://fileconvertfree.com/api1

Autenticazione

X-API-Key header

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

Avvio rapido

Accedi al tuo account FileConvertFree.

Usa un piano Premium o Pro attivo.

Apri Pannello → API per sviluppatori → Crea chiave API. Salva subito la chiave completa perché viene mostrata una sola volta.

Invia la chiave nell’header X-API-Key con ogni richiesta API protetta.

Piani e limiti API

I limiti sono condivisi a livello di account tra tutte le chiavi API. Creare più chiavi non crea più quota.

Premium

200 / day

200 Richieste giornaliere
30 Richieste / minuto
200 MB Dimensione massima file
3 Chiavi attive max

Pro

400 / day

400 Richieste giornaliere
60 Richieste / minuto
200 MB Dimensione massima file
3 Chiavi attive max

Gestione delle chiavi API

1. Crea una chiave

Vai al Pannello e apri la sezione API per sviluppatori. Puoi mantenere fino a 3 chiavi API attive. Usa nomi utili come Produzione, App ufficio o Staging.

2. Salvala subito

Il segreto completo viene mostrato solo dopo la creazione o rigenerazione. FileConvertFree conserva un hash sicuro, non il segreto in chiaro, quindi la chiave completa non può essere mostrata in seguito.

3. Rigenera una chiave

La rigenerazione crea un nuovo segreto e revoca immediatamente la vecchia chiave. Aggiorna l’applicazione con la nuova chiave prima di chiudere la finestra che mostra il segreto una sola volta.

4. Revoca una chiave

Revoca una chiave se non serve più o potrebbe essere stata esposta. Smette immediatamente di autenticare. Il record di una chiave revocata viene eliminato automaticamente dopo 7 giorni.

Regole di sicurezza

Non condividere mai una chiave API, non pubblicarla su GitHub, non inserirla in JavaScript lato browser, non inviarla negli screenshot e non conservarla in codice pubblico. Tienila nelle variabili d’ambiente del server o in un gestore di segreti. Se una chiave potrebbe essere compromessa, rigenerala o revocala subito.

Endpoint disponibili

Metodo	Endpoint	Scopo / opzioni
GET	`/v1/account/usage`	Legge piano autenticato, stato della chiave, utilizzo giornaliero, quota rimanente e utilizzo del limite di frequenza.
GET	`/health`	Controllo pubblico dello stato e della versione API.
POST	`/v1/pdf/to-word`	Converte un file PDF valido in Word.
POST	`/v1/pdf/to-excel`	Converte un file PDF valido in Excel.
POST	`/v1/image/to-text`	Estrae testo OCR da un’immagine. Campo multipart facoltativo: fast=true\|false.
POST	`/v1/image/to-word`	Converte un’immagine in Word. Campo multipart facoltativo: fast=true\|false.
POST	`/v1/image/to-excel`	Converte un’immagine in Excel. Campo multipart facoltativo: fast=true\|false.
POST	`/v1/image/remove-background`	Rimuove lo sfondo di un’immagine. Campi facoltativi: format (png predefinito), transparent=true\|false, fast_mode=true\|false.

Esempi di codice

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());

Usa l’esempio JavaScript in un ambiente server/Node.js. Non esporre la chiave segreta nel JavaScript frontend o del browser.

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);

File supportati e convalida

Gli endpoint PDF accettano file PDF reali. Gli endpoint immagine accettano JPEG/JPG/JFIF, PNG, WebP, GIF, BMP e TIFF/TIF. L’API controlla sia l’estensione del nome sia la firma reale del file, quindi rinominare un file non supportato non aggira la convalida.

Comportamento delle risposte

Gli endpoint di conversione restituiscono direttamente al client il corpo del file convertito. Image-to-text restituisce JSON. Gli URL interni di download del convertitore non vengono esposti ai client API.

Errori HTTP e significato

Stato	Significato	Motivo tipico / azione
401	Chiave API mancante, non valida, scaduta o revocata.	Controlla X-API-Key. Se la chiave è stata revocata o rigenerata, sostituiscila con il segreto corrente.
403	Accesso API non abilitato.	Il tuo account non dispone attualmente di un piano Premium o Pro attivo con accesso valido.
409	L’azione sulla chiave è in conflitto con il suo stato corrente.	Ad esempio, tentare di creare più di 3 chiavi attive o rigenerare una chiave non attiva.
413	Il file caricato è troppo grande.	Usa un file entro il limite del tuo piano API (attualmente 200 MB).
415	Tipo di media non supportato o non corrispondente.	Usa un PDF o un’immagine supportata e mantieni l’estensione corretta; l’API verifica anche la firma del file.
422	Contenuto della richiesta non valido.	Il caricamento può essere vuoto oppure possono mancare dati multipart obbligatori o essere non validi.
429	Troppe richieste.	Hai raggiunto il limite al minuto o la quota giornaliera condivisa dell’account. Riprova più tardi o attendi il reset giornaliero.
5xx	Errore temporaneo dell’API o del servizio di conversione.	Riprova con backoff. Gli errori di infrastruttura o backend non vengono addebitati alla quota giornaliera.

Come viene conteggiata la quota

La quota giornaliera e i limiti al minuto sono condivisi tra tutte le chiavi dello stesso account API. I caricamenti non validi o non supportati rifiutati prima della conversione non consumano quota giornaliera. Gli errori di server o infrastruttura vengono rimborsati alla quota giornaliera. Le richieste accettate per la conversione possono contare anche se il convertitore a valle restituisce successivamente un errore client 4xx. La quota giornaliera si resetta in base al giorno di calendario del server/database API.

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

Domande frequenti

Un account Free può usare l’API?

No. La documentazione è pubblica, ma l’accesso API richiede attualmente un piano Premium o Pro attivo.

Creare 3 chiavi triplica la quota?

No. Le chiavi condividono gli stessi limiti giornalieri e al minuto dell’account.

Posso recuperare un segreto perso?

No. La chiave in chiaro non viene conservata. Rigenera la chiave e salva il nuovo segreto.

Cosa succede quando scade il piano a pagamento?

L’accesso API viene disabilitato quando l’account non ha più un piano idoneo attivo. Rinnova Premium o Pro per ripristinare l’accesso quando previsto.

Pronto a integrare FileConvertFree?

Crea la chiave dal pannello, provala con l’endpoint di utilizzo e poi collega la rotta di conversione necessaria alla tua applicazione.

Apri pannello Documentazione API interattiva