Authenticatie

Alle programmatische API-verzoeken vereisen een API Key voor authenticatie. Deze pagina legt uit hoe je je verzoeken kunt authenticeren.

De x-api-key header

Voeg je API Key toe in de x-api-key HTTP-header bij elk verzoek. De API Key is een tekenreeks die begint met fft_.

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)

Anonieme toegang

De FreeFileTools-website gebruikt dezelfde API-endpoints intern voor browsergebaseerde bestandsverwerking. Anonieme toegang (zonder API Key) werkt voor browserverzoeken afkomstig van freefiletools.io.

Echter, programmatische toegang vanuit externe applicaties vereist een API Key. Verzoeken zonder geldige API Key van buiten de browser ontvangen een 401 Unauthorized-respons.

Foutresponsen

API Key ontbreekt of is ongeldig

json

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

HTTP-status: 401

Snelheidslimiet overschreden

json

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

HTTP-status: 429

Volgende stappen

API Key-beheer -- Leer hoe je API Keys aanmaakt, regenereert en beveiligt.

Snelheidslimieten -- Begrijp snelheidslimieten en hoe je ermee omgaat.