FileConvertFree Geliştirici Platformu

Dosya dönüştürmeyi uygulamanıza ekleyin

FileConvertFree REST API ile kendi uygulamanızdan, sunucu tarafı sisteminizden, otomasyonunuzdan veya şirket iş akışınızdan PDF ve görüntü dosyalarını dönüştürün.

API v1: Dokümantasyon herkese açıktır. API istekleri için aktif bir Premium veya Pro FileConvertFree hesabı gerekir.

Paneli Aç Planları Gör Etkileşimli API Dokümanı

Temel URL

REST API v1

https://fileconvertfree.com/api1

Kimlik doğrulama

X-API-Key header

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

Hızlı başlangıç

FileConvertFree hesabınızda oturum açın.

Aktif bir Premium veya Pro plan kullanın.

Panel → Geliştirici API → API Anahtarı Oluştur bölümünü açın. Tam anahtar yalnızca bir kez gösterildiği için hemen güvenli bir yerde saklayın.

Korunan her API isteğinde anahtarı X-API-Key başlığıyla gönderin.

API planları ve limitleri

Limitler hesabınızdaki tüm API anahtarları için ortaktır. Daha fazla anahtar oluşturmak toplam kotayı artırmaz.

Premium

200 / day

200 Günlük istek
30 Dakika başına istek
200 MB Maksimum dosya boyutu
3 Aktif anahtar max

Pro

400 / day

400 Günlük istek
60 Dakika başına istek
200 MB Maksimum dosya boyutu
3 Aktif anahtar max

API anahtarı yönetimi

1. Anahtar oluşturun

Paneldeki Geliştirici API bölümünden en fazla 3 aktif API anahtarı oluşturabilirsiniz. Production, Office App veya Staging gibi anlaşılır adlar kullanın.

2. Anahtarı hemen kaydedin

Tam gizli anahtar yalnızca oluşturma veya yeniden oluşturma işleminden sonra gösterilir. FileConvertFree açık metin anahtar yerine güvenli bir özet değer saklar; bu nedenle tam anahtar daha sonra yeniden görüntülenemez.

3. Anahtarı yeniden oluşturun

Yeniden oluşturma yeni bir gizli anahtar üretir ve eski anahtarı hemen geçersiz kılar. Tek seferlik anahtar penceresini kapatmadan önce uygulamanızı yeni anahtarla güncelleyin.

4. Anahtarı iptal edin

Artık kullanılmayan veya açığa çıkmış olabilecek anahtarı iptal edin. Kimlik doğrulaması hemen durur. İptal edilen anahtara ait kayıt 7 gün sonra otomatik olarak silinir.

Güvenlik kuralları

API anahtarını paylaşmayın, GitHub gibi herkese açık depolara koymayın, tarayıcı tarafı JavaScript içinde kullanmayın veya ekran görüntülerinde yayınlamayın. Sunucu ortam değişkenleri ya da bir gizli bilgi yöneticisi kullanın. Anahtarın açığa çıktığından şüphelenirseniz hemen yeniden oluşturun veya iptal edin.

Kullanılabilir endpointler

Yöntem	Endpoint	Amaç / seçenekler
GET	`/v1/account/usage`	Kimliği doğrulanmış planı, anahtar durumunu, günlük kullanımı, kalan kotayı ve hız limiti kullanımını görüntüler.
GET	`/health`	API durumu ve sürümü için herkese açık sağlık kontrolü.
POST	`/v1/pdf/to-word`	Geçerli bir PDF dosyasını Word belgesine dönüştürür.
POST	`/v1/pdf/to-excel`	Geçerli bir PDF dosyasını Excel dosyasına dönüştürür.
POST	`/v1/image/to-text`	Bir görüntüden OCR ile metin çıkarır. İsteğe bağlı multipart alanı: fast=true\|false.
POST	`/v1/image/to-word`	Bir görüntüyü Word belgesine dönüştürür. İsteğe bağlı multipart alanı: fast=true\|false.
POST	`/v1/image/to-excel`	Bir görüntüyü Excel dosyasına dönüştürür. İsteğe bağlı multipart alanı: fast=true\|false.
POST	`/v1/image/remove-background`	Görüntü arka planını kaldırır. İsteğe bağlı alanlar: format (varsayılan png), transparent=true\|false, fast_mode=true\|false.

Kod örnekleri

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

JavaScript örneğini sunucu/Node.js ortamında kullanın. Gizli API anahtarınızı tarayıcıdaki frontend JavaScript kodunda açığa çıkarmayın.

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

Desteklenen dosyalar ve doğrulama

PDF endpointleri gerçek PDF dosyalarını kabul eder. Görüntü endpointleri JPEG/JPG/JFIF, PNG, WebP, GIF, BMP ve TIFF/TIF kabul eder. API hem dosya uzantısını hem gerçek dosya imzasını kontrol eder; desteklenmeyen bir dosyanın adını değiştirmek doğrulamayı atlatmaz.

Yanıt davranışı

Dosya dönüştürme endpointleri dönüştürülen dosyanın içeriğini doğrudan istemciye döndürür. Image-to-text JSON döndürür. Dahili dönüştürücü indirme URL’leri API müşterilerine açılmaz.

HTTP hataları ve anlamları

Durum	Anlamı	Olası neden / yapılacak işlem
401	API anahtarı eksik, geçersiz, süresi dolmuş veya iptal edilmiş.	X-API-Key değerini kontrol edin. Anahtar iptal edildi veya yeniden oluşturulduysa mevcut gizli anahtarla değiştirin.
403	API erişimi etkin değil.	Hesabınızda şu anda aktif Premium veya Pro yetkisi yok.
409	Anahtar işlemi mevcut durumuyla çakışıyor.	Örneğin 3’ten fazla aktif anahtar oluşturmaya çalışmak veya aktif olmayan bir anahtarı yeniden oluşturmak.
413	Yüklenen dosya çok büyük.	API planınızın dosya boyutu sınırı içinde bir dosya kullanın (şu anda 200 MB).
415	Desteklenmeyen veya eşleşmeyen medya türü.	Desteklenen bir PDF/görüntü kullanın ve doğru uzantıyı koruyun; API dosya imzasını da doğrular.
422	Geçersiz istek içeriği.	Yükleme boş olabilir veya gerekli multipart verisi eksik/geçersiz olabilir.
429	Çok fazla istek.	Dakika başına hız limitine veya hesap genelindeki günlük kotaya ulaşıldı. Daha sonra tekrar deneyin veya günlük sıfırlamayı bekleyin.
5xx	Geçici API veya dönüştürme hizmeti hatası.	Gecikmeli olarak tekrar deneyin. Altyapı/sunucu hataları günlük kotadan düşülmez.

Kota nasıl hesaplanır

Günlük kota ve dakika başına hız limiti aynı API hesabındaki tüm anahtarlar arasında paylaşılır. Dönüştürme başlamadan reddedilen geçersiz veya desteklenmeyen yüklemeler günlük kotayı tüketmez. Sunucu ve altyapı hatalarında ayrılmış günlük kota geri verilir. Dönüştürmeye kabul edilen bir istek, alt dönüştürücü daha sonra istemci kaynaklı 4xx hatası döndürse bile hesaba katılabilir. Günlük kota API sunucusu/veritabanı takvim gününe göre sıfırlanır.

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

Sık sorulan sorular

Free hesap API kullanabilir mi?

Hayır. Dokümantasyon herkese açıktır ancak API erişimi için şu anda aktif Premium veya Pro web planı gerekir.

3 anahtar oluşturmak kotamı üç katına çıkarır mı?

Hayır. Tüm anahtarlar hesap genelindeki aynı günlük ve dakika başına limitleri paylaşır.

Kaybettiğim gizli anahtarı geri alabilir miyim?

Hayır. Açık metin gizli anahtar saklanmaz. Anahtarı yeniden oluşturun ve yeni gizli değeri güvenli bir yerde saklayın.

Ücretli planım sona ererse ne olur?

Web sitesi hesabınızda aktif ve uygun bir plan kalmadığında API erişimi devre dışı bırakılır. Premium veya Pro planınızı yenileyerek erişimi yeniden etkinleştirebilirsiniz.

FileConvertFree entegrasyonuna hazır mısınız?

Panelden anahtarınızı oluşturun, kullanım endpointi ile test edin ve uygulamanızın ihtiyaç duyduğu dönüştürme rotasını bağlayın.

Paneli Aç Etkileşimli API Dokümanı