Autentisering

Alla programmatiska API-forfragninar kraver en API Key for autentisering. Den har sidan forklarar hur du autentiserar dina forfragninar.

x-api-key-huvudet

Inkludera din API Key i HTTP-huvudet x-api-key med varje forfragen. API Key ar en strang som borjar med 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)

Anonym atkomst

FreeFileTools webbplats anvander samma API-slutpunkter internt for webblasarbaserad filbearbetning. Anonym atkomst (utan API Key) fungerar for webbforfragninar fran freefiletools.io.

Dock kraver programmatisk atkomst fran externa applikationer en API Key. Forfragninar utan en giltig API Key fran utanfor webblasaren far ett 401 Unauthorized-svar.

Felsvar

Saknad eller ogiltig API Key

json

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

HTTP-status: 401

Hastighetsgrans overskriden

json

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

HTTP-status: 429

Nasta steg

API Key-hantering -- Lar dig hur du skapar, aterskapar och sakrar dina API Keys.

Hastighetsgranser -- Forsta hastighetsgranser och hur du hanterar dem.