Autenticacao

Todas as requisicoes programaticas da API requerem uma API key para autenticacao. Esta pagina explica como autenticar suas requisicoes.

O cabecalho x-api-key

Inclua sua API key no cabecalho HTTP x-api-key em cada requisicao. A API key e uma string que comeca com 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)

Acesso anonimo

O site FreeFileTools usa os mesmos endpoints da API internamente para processamento de arquivos no navegador. O acesso anonimo (sem API key) funciona para requisicoes do navegador originadas de freefiletools.io.

No entanto, o acesso programatico de aplicacoes externas requer uma API key. Requisicoes sem uma API key valida de fora do navegador receberao uma resposta 401 Unauthorized.

Respostas de erro

API key ausente ou invalida

json

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

Status HTTP: 401

Limite de taxa excedido

json

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

Status HTTP: 429

Proximos passos

Gerenciamento de API Keys -- Aprenda como criar, regenerar e proteger suas API keys.

Limites de taxa -- Entenda os limites de taxa e como lidar com eles.