Autentificare

Toate cererile API programatice necesita un API Key pentru autentificare. Aceasta pagina explica cum sa-ti autentifici cererile.

Antetul x-api-key

Include API Key-ul tau in antetul HTTP x-api-key la fiecare cerere. API Key-ul este un sir de caractere care incepe cu 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 anonim

Site-ul FreeFileTools foloseste aceleasi puncte finale API intern pentru procesarea fisierelor in browser. Accesul anonim (fara API Key) functioneaza pentru cererile din browser provenind de la freefiletools.io.

Cu toate acestea, accesul programatic din aplicatii externe necesita un API Key. Cererile fara un API Key valid din afara browserului vor primi un raspuns 401 Unauthorized.

Raspunsuri de eroare

API Key lipsa sau invalid

json

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

Status HTTP: 401

Limita de rata depasita

json

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

Status HTTP: 429

Pasii urmatori

Gestionarea API Key -- Afla cum sa creezi, regenerezi si securizezi API Key-urile tale.

Limite de rata -- Intelege limitele de rata si cum sa le gestionezi.