Ταυτοποίηση

Όλα τα προγραμματιστικά αιτήματα API απαιτούν API Key για ταυτοποίηση. Αυτή η σελίδα εξηγεί πώς να ταυτοποιήσετε τα αιτήματά σας.

Η κεφαλίδα x-api-key

Συμπεριλάβετε το API Key σας στην κεφαλίδα HTTP x-api-key με κάθε αίτημα. Το API Key είναι μια συμβολοσειρά που ξεκινά με 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)

Ανώνυμη πρόσβαση

Ο ιστότοπος FreeFileTools χρησιμοποιεί τα ίδια τελικά σημεία API εσωτερικά για επεξεργασία αρχείων στον περιηγητή. Η ανώνυμη πρόσβαση (χωρίς API Key) λειτουργεί για αιτήματα περιηγητή από το freefiletools.io.

Ωστόσο, η προγραμματιστική πρόσβαση από εξωτερικές εφαρμογές απαιτεί API Key. Αιτήματα χωρίς έγκυρο API Key από εξωτερικές πηγές θα λάβουν απόκριση 401 Unauthorized.

Αποκρίσεις σφάλματος

Ελλιπές ή μη έγκυρο API Key

json

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

Κατάσταση HTTP: 401

Υπέρβαση ορίου αιτημάτων

json

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

Κατάσταση HTTP: 429

Επόμενα βήματα

Διαχείριση API Key -- Μάθετε πώς να δημιουργείτε, αναδημιουργείτε και ασφαλίζετε τα API Keys σας.

Όρια αιτημάτων -- Κατανοήστε τα όρια αιτημάτων και πώς να τα διαχειρίζεστε.