Platforma FileConvertFree dla programistów

Dodaj konwersję plików do swojej aplikacji

Korzystaj z REST API FileConvertFree w aplikacjach, backendach, automatyzacjach i systemach firmowych do konwersji PDF oraz obrazów.

API v1: Dokumentacja jest publiczna. Wywołania API wymagają aktywnego planu Premium lub Pro.

Otwórz panel Zobacz plany Interaktywna dokumentacja API

Bazowy adres URL

REST API v1

https://fileconvertfree.com/api1

Uwierzytelnianie

X-API-Key header

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

Szybki start

Zaloguj się na swoje konto FileConvertFree.

Upewnij się, że masz aktywny plan Premium lub Pro.

Otwórz Panel → API dla programistów → Utwórz klucz API. Zapisz pełny klucz od razu, ponieważ jest wyświetlany tylko raz.

Wysyłaj klucz w nagłówku X-API-Key przy każdym chronionym żądaniu API.

Plany i limity API

Limity są wspólne dla całego konta API i wszystkich kluczy. Utworzenie dodatkowych kluczy nie zwiększa dostępnej kwoty.

Premium

200 / day

200 Żądania dziennie
30 Żądania na minutę
200 MB Maksymalny rozmiar pliku
3 Aktywne klucze max

Pro

400 / day

400 Żądania dziennie
60 Żądania na minutę
200 MB Maksymalny rozmiar pliku
3 Aktywne klucze max

Zarządzanie kluczami API

1. Utwórz klucz

W Panelu, w sekcji API dla programistów, możesz utrzymywać do 3 aktywnych kluczy API. Nadawaj im czytelne nazwy, np. Produkcja, Aplikacja biurowa lub Testy.

2. Zapisz go od razu

Pełny sekret jest pokazywany tylko po utworzeniu lub regeneracji. FileConvertFree przechowuje bezpieczny skrót, a nie jawny sekret, dlatego pełnego klucza nie można później ponownie wyświetlić.

3. Regeneracja klucza

Regeneracja tworzy nowy sekret i natychmiast unieważnia poprzedni klucz. Zaktualizuj aplikację nowym kluczem przed zamknięciem jednorazowego okna z sekretem.

4. Unieważnij klucz

Unieważnij klucz, jeśli nie jest już potrzebny lub mógł zostać ujawniony. Przestaje działać natychmiast. Rekord unieważnionego klucza jest automatycznie usuwany po 7 dniach.

Zasady bezpieczeństwa

Nigdy nie udostępniaj klucza API, nie publikuj go w GitHubie, nie umieszczaj w kodzie JavaScript działającym w przeglądarce, nie wysyłaj go na zrzutach ekranu i nie zapisuj w publicznym kodzie. Przechowuj go w zmiennych środowiskowych serwera lub menedżerze sekretów. Jeśli klucz mógł zostać ujawniony, natychmiast go zregeneruj lub unieważnij.

Dostępne endpointy

Metoda	Endpoint	Zastosowanie / opcje
GET	`/v1/account/usage`	Odczytuje plan konta, status klucza, dzienne użycie, pozostałą kwotę oraz wykorzystanie limitu żądań.
GET	`/health`	Publiczne sprawdzenie stanu i wersji API.
POST	`/v1/pdf/to-word`	Konwertuje prawidłowy plik PDF do Word.
POST	`/v1/pdf/to-excel`	Konwertuje prawidłowy plik PDF do Excel.
POST	`/v1/image/to-text`	Wyodrębnia tekst OCR z obrazu. Opcjonalne pole multipart: fast=true\|false.
POST	`/v1/image/to-word`	Konwertuje obraz do Word. Opcjonalne pole multipart: fast=true\|false.
POST	`/v1/image/to-excel`	Konwertuje obraz do Excel. Opcjonalne pole multipart: fast=true\|false.
POST	`/v1/image/remove-background`	Usuwa tło obrazu. Opcjonalne pola: format (domyślnie png), transparent=true\|false, fast_mode=true\|false.

Przykłady kodu

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

Przykładu JavaScript używaj po stronie serwera lub w Node.js. Nie ujawniaj tajnego klucza w kodzie frontendowym działającym w przeglądarce.

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

Obsługiwane pliki i walidacja

Endpointy PDF przyjmują rzeczywiste pliki PDF. Endpointy obrazów obsługują JPEG/JPG/JFIF, PNG, WebP, GIF, BMP oraz TIFF/TIF. API sprawdza zarówno rozszerzenie nazwy pliku, jak i rzeczywistą sygnaturę, dlatego samo przemianowanie nieobsługiwanego pliku nie omija walidacji.

Sposób zwracania odpowiedzi

Endpointy konwersji plików zwracają gotowy plik bezpośrednio do klienta. Image-to-text zwraca JSON. Wewnętrzne adresy pobierania konwerterów nie są udostępniane klientom API.

Błędy HTTP i ich znaczenie

Status	Znaczenie	Typowa przyczyna / działanie
401	Brakujący, nieprawidłowy, wygasły lub unieważniony klucz API.	Sprawdź nagłówek X-API-Key. Jeśli klucz został unieważniony lub zregenerowany, zastąp go aktualnym sekretem.
403	Dostęp do API nie jest włączony.	Konto nie ma obecnie aktywnego uprawnienia Premium lub Pro.
409	Operacja na kluczu jest sprzeczna z jego aktualnym stanem.	Przykłady: próba utworzenia więcej niż 3 aktywnych kluczy albo regeneracja klucza, który nie jest aktywny.
413	Przesłany plik jest zbyt duży.	Użyj pliku mieszczącego się w limicie planu API (obecnie 200 MB).
415	Nieobsługiwany lub niezgodny typ danych.	Użyj obsługiwanego PDF lub obrazu i zachowaj prawidłowe rozszerzenie; API sprawdza również sygnaturę pliku.
422	Nieprawidłowa zawartość żądania.	Plik może być pusty albo wymagane dane multipart mogą być brakujące lub nieprawidłowe.
429	Zbyt wiele żądań.	Osiągnięto limit żądań na minutę albo wspólną dzienną kwotę konta. Spróbuj ponownie później lub poczekaj na dzienny reset.
5xx	Tymczasowy błąd API lub usługi konwersji.	Ponów żądanie z opóźnieniem. Błędy infrastruktury/backendu nie są naliczane do dziennej kwoty.

Jak liczona jest kwota

Dzienna kwota i limity żądań na minutę są współdzielone przez wszystkie klucze tego samego konta API. Nieprawidłowe lub nieobsługiwane pliki odrzucone przed uruchomieniem konwersji nie zużywają dziennej kwoty. Błędy serwera lub infrastruktury zwracają zarezerwowaną kwotę. Żądanie przyjęte do konwersji może zostać policzone nawet wtedy, gdy wewnętrzny konwerter później zwróci błąd klienta 4xx. Dzienna kwota resetuje się według dnia kalendarzowego serwera/bazy danych API.

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

Najczęstsze pytania

Czy konto Free może korzystać z API?

Nie. Dokumentacja jest dostępna publicznie, ale wywołania API wymagają obecnie aktywnego planu Premium lub Pro.

Czy utworzenie 3 kluczy potraja mój limit?

Nie. Wszystkie klucze korzystają ze wspólnych dziennych i minutowych limitów konta.

Czy można odzyskać utracony sekret?

Nie. Jawny sekret nie jest przechowywany. Zregeneruj klucz i zapisz nowy sekret.

Co się stanie po wygaśnięciu płatnego planu?

Dostęp do API zostaje wyłączony, gdy konto nie ma już aktywnego kwalifikującego planu. Odnów Premium lub Pro, aby ponownie uzyskać dostęp.

Gotowy na integrację FileConvertFree?

Utwórz klucz w Panelu, sprawdź go za pomocą endpointu usage, a następnie podłącz trasę konwersji potrzebną Twojej aplikacji.

Otwórz panel Interaktywna dokumentacja API