Authentification

Toutes les requetes API programmatiques necessitent un API key pour l'authentification. Cette page explique comment authentifier vos requetes.

L'en-tete x-api-key

Incluez votre API key dans l'en-tete HTTP x-api-key avec chaque requete. L'API key est une chaine qui commence par 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)

Acces anonyme

Le site web FreeFileTools utilise les memes endpoints API en interne pour le traitement de fichiers dans le navigateur. L'acces anonyme (sans API key) fonctionne pour les requetes du navigateur provenant de freefiletools.io.

Cependant, l'acces programmatique depuis des applications externes necessite un API key. Les requetes sans API key valide provenant de l'exterieur du navigateur recevront une reponse 401 Unauthorized.

Reponses d'erreur

API key manquant ou invalide

json

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

Statut HTTP : 401

Limite de debit depassee

json

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

Statut HTTP : 429

Prochaines etapes

Gestion des API Keys -- Apprenez a creer, regenerer et securiser vos API keys.

Limites de debit -- Comprenez les limites de debit et comment les gerer.