المصادقة
تتطلب جميع طلبات 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.jpgJavaScript / 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.
حدود المعدل -- افهم حدود المعدل وكيفية التعامل معها.