Kimlik Dogrulama

Tum programatik API istekleri kimlik dogrulama icin bir API anahtarı gerektirir. Bu sayfa isteklerinizi nasıl dogrulayacagınızı acıklar.

x-api-key Baslıgı

Her istekte x-api-key HTTP baslıgına API anahtarınızı ekleyin. API anahtarı fft_ ile baslayan bir dizedir.

cURL

bash

curl -X POST https://freefiletools.io/api/image-compress \
  -H "x-api-key: fft_your_api_key_here" \
  -F "[email protected]" \
  -F "quality=80" \
  -o compressed.jpg

JavaScript / fetch

javascript

const formData = new FormData();
formData.append("file", fileInput.files[0]);
formData.append("quality", "80");

const response = await fetch("https://freefiletools.io/api/image-compress", {
  method: "POST",
  headers: {
    "x-api-key": "fft_your_api_key_here",
  },
  body: formData,
});

const blob = await response.blob();

Python

python

import requests

headers = {
    "x-api-key": "fft_your_api_key_here"
}

files = {
    "file": ("image.jpg", open("image.jpg", "rb"), "image/jpeg")
}

data = {
    "quality": "80"
}

response = requests.post(
    "https://freefiletools.io/api/image-compress",
    headers=headers,
    files=files,
    data=data
)

with open("compressed.jpg", "wb") as f:
    f.write(response.content)

Anonim Erisim

FreeFileTools web sitesi, tarayıcı tabanlı dosya isleme icin aynı API uc noktalarını dahili olarak kullanır. freefiletools.io'dan gelen tarayıcı istekleri icin anonim erisim (API anahtarı olmadan) calısır.

Ancak, harici uygulamalardan programatik erisim bir API anahtarı gerektirir. Tarayıcı dısından gecerli bir API anahtarı olmadan gonderilen istekler 401 Unauthorized yanıtı alacaktır.

Hata Yanıtları

Eksik veya gecersiz API anahtarı

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key. Get your key at freefiletools.io/dashboard/api-keys"
}

HTTP Durumu: 401

Hız sınırı asıldı

json

{
  "error": "Rate limit exceeded",
  "message": "You have exceeded the rate limit. Please try again later."
}

HTTP Durumu: 429

Sonraki Adımlar

API Anahtarı Yonetimi -- API anahtarlarınızı nasıl olusturacagınızı, yenileyeceginizi ve guvenli tutacagınızı ogrenin.

Hız Sınırları -- Hız sınırlarını anlayın ve nasıl ele alacagınızı ogrenin.