Docsالمصادقة

المصادقة

تتطلب جميع طلبات 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.

حدود المعدل -- افهم حدود المعدل وكيفية التعامل معها.