Autenticazione

Tutte le richieste API programmatiche richiedono un API key per l'autenticazione. Questa pagina spiega come autenticare le tue richieste.

L'intestazione x-api-key

Includi la tua API key nell'intestazione HTTP x-api-key con ogni richiesta. L'API key e una stringa che inizia con 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)

Accesso anonimo

Il sito web FreeFileTools utilizza internamente gli stessi endpoint API per l'elaborazione dei file nel browser. L'accesso anonimo (senza API key) funziona per le richieste del browser provenienti da freefiletools.io.

Tuttavia, l'accesso programmatico da applicazioni esterne richiede un API key. Le richieste senza un API key valida provenienti dall'esterno del browser riceveranno una risposta 401 Unauthorized.

Risposte di errore

API key mancante o non valida

json

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

Stato HTTP: 401

Limite di frequenza superato

json

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

Stato HTTP: 429

Prossimi passi

Gestione API Keys -- Scopri come creare, rigenerare e proteggere le tue API keys.

Limiti di frequenza -- Comprendi i limiti di frequenza e come gestirli.