Plateforme FileConvertFree pour développeurs

Intégrez la conversion de fichiers à votre application

Utilisez l’API REST FileConvertFree dans vos applications, automatisations, systèmes d’entreprise ou flux bureautiques.

API v1: La documentation est publique. Les appels API exigent un forfait FileConvertFree Premium ou Pro actif.

Ouvrir le tableau de bord Voir les offres Documentation API interactive

URL de base

REST API v1

https://fileconvertfree.com/api1

Authentification

X-API-Key header

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

Démarrage rapide

Connectez-vous à votre compte FileConvertFree.

Utilisez un forfait Premium ou Pro actif.

Ouvrez Tableau de bord → API développeur → Créer une clé API. Enregistrez immédiatement la clé complète, car elle n’est affichée qu’une seule fois.

Envoyez la clé dans l’en-tête X-API-Key avec chaque requête API protégée.

Offres et limites API

Les limites sont partagées à l’échelle du compte entre toutes vos clés API. Créer davantage de clés n’ajoute pas de quota.

Premium

200 / day

200 Requêtes quotidiennes
30 Requêtes / minute
200 MB Taille maximale du fichier
3 Clés actives max

Pro

400 / day

400 Requêtes quotidiennes
60 Requêtes / minute
200 MB Taille maximale du fichier
3 Clés actives max

Gestion des clés API

1. Créer une clé

Dans le tableau de bord, utilisez la section API développeur. Vous pouvez conserver jusqu’à 3 clés API actives. Donnez-leur des noms utiles, par exemple Production, Application bureau ou Préproduction.

2. Enregistrez-la immédiatement

Le secret complet n’est affiché qu’après la création ou la régénération. FileConvertFree stocke un hachage sécurisé, et non le secret en clair ; la clé complète ne peut donc pas être réaffichée plus tard.

3. Régénérer une clé

La régénération crée un nouveau secret et révoque immédiatement l’ancien. Mettez votre application à jour avec la nouvelle clé avant de fermer la fenêtre qui affiche le secret une seule fois.

4. Révoquer une clé

Révoquez une clé si elle n’est plus nécessaire ou si elle a pu être exposée. Elle cesse immédiatement de fonctionner pour l’authentification. L’enregistrement d’une clé révoquée est automatiquement supprimé après 7 jours.

Règles de sécurité

Ne partagez jamais une clé API, ne la publiez pas sur GitHub, ne l’insérez pas dans du JavaScript exécuté dans le navigateur, ne l’envoyez pas dans des captures d’écran et ne la stockez pas dans du code public. Conservez-la dans des variables d’environnement serveur ou un gestionnaire de secrets. En cas de suspicion de compromission, régénérez ou révoquez immédiatement la clé.

Endpoints disponibles

Méthode	Endpoint	Fonction / options
GET	`/v1/account/usage`	Consulte le forfait authentifié, l’état de la clé, l’utilisation quotidienne, le quota restant et l’utilisation de la limite de débit.
GET	`/health`	Vérification publique de l’état et de la version de l’API.
POST	`/v1/pdf/to-word`	Convertit un fichier PDF valide en Word.
POST	`/v1/pdf/to-excel`	Convertit un fichier PDF valide en Excel.
POST	`/v1/image/to-text`	Extrait du texte par OCR à partir d’une image. Champ multipart facultatif : fast=true\|false.
POST	`/v1/image/to-word`	Convertit une image en Word. Champ multipart facultatif : fast=true\|false.
POST	`/v1/image/to-excel`	Convertit une image en Excel. Champ multipart facultatif : fast=true\|false.
POST	`/v1/image/remove-background`	Supprime l’arrière-plan d’une image. Champs facultatifs : format (png par défaut), transparent=true\|false, fast_mode=true\|false.

Exemples de code

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

Utilisez l’exemple JavaScript dans un environnement serveur/Node.js. N’exposez pas votre clé secrète dans du JavaScript frontend exécuté dans le navigateur.

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

Fichiers acceptés et validation

Les endpoints PDF acceptent de vrais fichiers PDF. Les endpoints image acceptent JPEG/JPG/JFIF, PNG, WebP, GIF, BMP et TIFF/TIF. L’API vérifie à la fois l’extension du nom de fichier et la signature réelle du fichier ; renommer simplement un fichier non pris en charge ne contourne donc pas la validation.

Comportement des réponses

Les endpoints de conversion renvoient directement le contenu du fichier converti au client. Image vers texte renvoie du JSON. Les URL de téléchargement internes des convertisseurs ne sont pas exposées aux clients de l’API.

Erreurs HTTP et signification

Statut	Signification	Cause habituelle / action
401	Clé API absente, invalide, expirée ou révoquée.	Vérifiez X-API-Key. Si la clé a été révoquée ou régénérée, remplacez-la par le secret actuel.
403	L’accès API n’est pas activé.	Votre compte ne dispose pas actuellement d’un droit Premium ou Pro actif.
409	L’action sur la clé est incompatible avec son état actuel.	Exemples : tentative de créer plus de 3 clés actives ou de régénérer une clé qui n’est pas active.
413	Le fichier téléversé est trop volumineux.	Utilisez un fichier respectant la limite de votre forfait API (actuellement 200 Mo).
415	Type de média non pris en charge ou incohérent.	Utilisez un PDF ou une image pris en charge et conservez la bonne extension ; l’API valide aussi la signature du fichier.
422	Contenu de requête invalide.	Le téléversement peut être vide ou certaines données multipart requises peuvent être absentes ou invalides.
429	Trop de requêtes.	Vous avez atteint la limite par minute ou le quota quotidien partagé du compte. Réessayez plus tard ou attendez la réinitialisation quotidienne.
5xx	Échec temporaire de l’API ou du service de conversion.	Réessayez avec un délai progressif. Les défaillances d’infrastructure ou du backend ne sont pas facturées au quota quotidien.

Fonctionnement du comptage du quota

Le quota quotidien et les limites par minute sont partagés entre toutes les clés du même compte API. Les téléversements invalides ou non pris en charge rejetés avant la conversion ne consomment pas le quota quotidien. Les échecs serveur ou d’infrastructure sont recrédités. Une requête acceptée pour conversion peut être comptabilisée même si le convertisseur en aval renvoie ensuite une erreur 4xx côté client. Le quota quotidien se réinitialise selon le jour calendaire du serveur ou de la base de données API.

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

Questions fréquentes

Un compte Free peut-il appeler l’API ?

Non. La documentation est visible par tous, mais l’accès API exige actuellement un forfait Premium ou Pro actif.

Créer 3 clés triple-t-il mon quota ?

Non. Les clés partagent les mêmes limites quotidiennes et par minute au niveau du compte.

Puis-je récupérer un secret perdu ?

Non. La clé en clair n’est pas stockée. Régénérez la clé et enregistrez le nouveau secret.

Que se passe-t-il lorsque mon forfait payant expire ?

L’accès API est désactivé lorsque le compte du site ne dispose plus d’un forfait éligible actif. Renouvelez Premium ou Pro pour rétablir l’accès.

Prêt à intégrer FileConvertFree ?

Créez votre clé depuis le tableau de bord, testez-la avec l’endpoint d’utilisation, puis connectez la route de conversion nécessaire à votre application.

Ouvrir le tableau de bord Documentation API interactive