Autenticacion

Todas las solicitudes programaticas a la API requieren un API key para autenticacion. Esta pagina explica como autenticar tus solicitudes.

El encabezado x-api-key

Incluye tu API key en el encabezado HTTP x-api-key con cada solicitud. El API key es una cadena que comienza 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)

Acceso anonimo

El sitio web de FreeFileTools utiliza los mismos endpoints de la API internamente para el procesamiento de archivos en el navegador. El acceso anonimo (sin API key) funciona para solicitudes del navegador originadas desde freefiletools.io.

Sin embargo, el acceso programatico desde aplicaciones externas requiere un API key. Las solicitudes sin un API key valido desde fuera del navegador recibiran una respuesta 401 Unauthorized.

Respuestas de error

API key faltante o invalido

json

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

Estado HTTP: 401

Limite de velocidad excedido

json

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

Estado HTTP: 429

Proximos pasos

Gestion de API Keys -- Aprende como crear, regenerar y proteger tus API keys.

Limites de velocidad -- Entiende los limites de velocidad y como manejarlos.