Platforma FileConvertFree pentru dezvoltatori

Integrează conversia fișierelor în aplicația ta

Folosește REST API FileConvertFree pentru conversia PDF-urilor și imaginilor din aplicații, backend-uri, automatizări sau fluxuri de lucru interne.

API v1: Documentația este publică. Cererile API necesită un cont FileConvertFree Premium sau Pro activ.

Deschide panoul Vezi planurile Documentație API interactivă

URL de bază

REST API v1

https://fileconvertfree.com/api1

Autentificare

X-API-Key header

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

Pornire rapidă

Autentifică-te în contul FileConvertFree.

Folosește un plan Premium sau Pro activ.

Deschide Panou → API pentru dezvoltatori → Creează cheie API. Salvează cheia completă imediat, deoarece este afișată o singură dată.

Trimite cheia în antetul X-API-Key la fiecare cerere API protejată.

Planuri și limite API

Limitele sunt comune întregului cont API și tuturor cheilor. Crearea mai multor chei nu mărește cota.

Premium

200 / day

200 cereri zilnice
30 cereri / minut
200 MB dimensiune maximă fișier
3 chei active max

Pro

400 / day

400 cereri zilnice
60 cereri / minut
200 MB dimensiune maximă fișier
3 chei active max

Gestionarea cheilor API

1. Creează o cheie

În secțiunea API pentru dezvoltatori din Panou poți păstra până la 3 chei API active. Folosește nume utile precum Production, Office App sau Staging.

2. Salveaz-o imediat

Secretul complet este afișat numai după creare sau regenerare. FileConvertFree păstrează un hash securizat, nu secretul în clar, deci cheia completă nu poate fi afișată ulterior.

3. Regenerează o cheie

Regenerarea creează un secret nou și revocă imediat cheia veche. Actualizează aplicația înainte de a închide dialogul cu secretul afișat o singură dată.

4. Revocă o cheie

Revocă o cheie dacă nu mai este necesară sau ar fi putut fi expusă. Autentificarea cu ea se oprește imediat. Înregistrarea unei chei revocate este ștearsă automat după 7 zile.

Reguli de securitate

Nu distribui cheia API, nu o publica pe GitHub, nu o include în JavaScript executat în browser și nu o salva în cod public. Păstreaz-o în variabile de mediu pe server sau într-un manager de secrete. Dacă suspectezi compromiterea ei, regenereaz-o sau revoc-o imediat.

Endpointuri disponibile

Metodă	Endpoint	Scop / opțiuni
GET	`/v1/account/usage`	Citește planul autentificat, starea cheii, utilizarea zilnică, cota rămasă și utilizarea limitei de rată.
GET	`/health`	Verificare publică a stării și versiunii API.
POST	`/v1/pdf/to-word`	Convertește un fișier PDF valid în Word.
POST	`/v1/pdf/to-excel`	Convertește un fișier PDF valid în Excel.
POST	`/v1/image/to-text`	Extrage text OCR dintr-o imagine. Câmp multipart opțional: fast=true\|false.
POST	`/v1/image/to-word`	Convertește o imagine în Word. Câmp multipart opțional: fast=true\|false.
POST	`/v1/image/to-excel`	Convertește o imagine în Excel. Câmp multipart opțional: fast=true\|false.
POST	`/v1/image/remove-background`	Elimină fundalul unei imagini. Câmpuri opționale: format (implicit png), transparent=true\|false, fast_mode=true\|false.

Exemple de cod

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

Folosește exemplul JavaScript într-un mediu de server/Node.js. Nu expune cheia secretă în JavaScript din frontend/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);

Fișiere acceptate și validare

Endpointurile PDF acceptă fișiere PDF reale. Endpointurile de imagini acceptă JPEG/JPG/JFIF, PNG, WebP, GIF, BMP și TIFF/TIF. API-ul verifică atât extensia, cât și semnătura reală a fișierului.

Comportamentul răspunsurilor

Endpointurile de conversie returnează corpul fișierului convertit direct clientului. Image-to-text returnează JSON. URL-urile interne de descărcare ale convertoarelor nu sunt expuse clienților API.

Erori HTTP și semnificația lor

Stare	Semnificație	Cauză tipică / acțiune
401	Cheie API lipsă, invalidă, expirată sau revocată.	Verifică X-API-Key. Dacă cheia a fost revocată sau regenerată, înlocuiește-o cu secretul curent.
403	Accesul API nu este activ.	Contul nu are momentan un plan Premium sau Pro eligibil activ.
409	Acțiunea asupra cheii intră în conflict cu starea actuală.	Exemple: încerci să creezi mai mult de 3 chei active sau să regenerezi o cheie inactivă.
413	Fișierul încărcat este prea mare.	Folosește un fișier în limita planului API (în prezent 200 MB).
415	Tip media neacceptat sau nepotrivit.	Folosește un PDF sau o imagine acceptată și păstrează extensia corectă; API-ul verifică și semnătura fișierului.
422	Conținutul cererii este invalid.	Fișierul poate fi gol sau datele multipart obligatorii pot lipsi ori fi invalide.
429	Prea multe cereri.	Ai atins limita pe minut sau cota zilnică a contului. Reîncearcă mai târziu sau după resetarea zilnică.
5xx	Eroare temporară API sau a serviciului de conversie.	Reîncearcă folosind backoff. Erorile de infrastructură/backend nu sunt taxate din cota zilnică.

Cum se calculează cota

Cota zilnică și limita pe minut sunt comune tuturor cheilor aceluiași cont API. Încărcările invalide sau neacceptate respinse înainte de conversie nu consumă cota zilnică. Erorile de server/infrastructură sunt restituite cotei. Cererile acceptate pentru conversie pot conta chiar dacă serviciul din aval întoarce ulterior o eroare 4xx. Cota zilnică se resetează conform zilei calendaristice a serverului/bazei de date API.

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

Întrebări frecvente

Poate un cont Free să folosească API-ul?

Nu. Documentația este publică, însă accesul API necesită momentan un plan Premium sau Pro activ.

Trei chei îmi triplează cota?

Nu. Cheile folosesc aceeași cotă zilnică și aceeași limită pe minut la nivel de cont.

Pot recupera un secret pierdut?

Nu. Cheia în clar nu este stocată. Regenerează cheia și salvează noul secret.

Ce se întâmplă când expiră planul plătit?

Accesul API este dezactivat când contul nu mai are un plan eligibil activ. Reînnoiește Premium sau Pro pentru a restabili accesul eligibil.

Ești gata să integrezi FileConvertFree?

Creează cheia din Panou, testeaz-o cu endpointul de utilizare, apoi conectează ruta de conversie necesară aplicației tale.

Deschide panoul Documentație API interactivă