Docsالبدء

البدء

ابدأ باستخدام FreeFileTools API في دقائق قليلة فقط. اتبع هذه الخطوات لإجراء أول استدعاء API.

الخطوة 1: إنشاء حساب

سجّل للحصول على حساب مجاني في freefiletools.io. لا حاجة لبطاقة ائتمان. يمكنك استخدام بريدك الإلكتروني أو تسجيل الدخول بحساب Google.

الخطوة 2: إنشاء API Key

بعد تسجيل الدخول، انتقل إلى لوحة التحكم ثم إلى API Keys. انقر على إنشاء API Key لتوليد مفتاحك.

سيبدو API Key الخاص بك كالتالي: fft_abc123...

مهم: انسخ واحفظ API Key بأمان. لن تتمكن من رؤية المفتاح الكامل مرة أخرى بعد الإنشاء.

الخطوة 3: إرسال طلبك الأول

أدرج API Key في رأس x-api-key مع كل طلب. إليك مثال بسيط باستخدام 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

مثال عملي كامل

إليك مثال كامل بـ Node.js يضغط صورة ويحفظ النتيجة:

javascript
const fs = require("fs");

async function compressImage() {
  const formData = new FormData();
  formData.append("file", new Blob([fs.readFileSync("photo.jpg")]), "photo.jpg");
  formData.append("quality", "75");

  const response = await fetch("https://freefiletools.io/api/image-compress", {
    method: "POST",
    headers: {
      "x-api-key": "fft_your_api_key_here",
    },
    body: formData,
  });

  if (!response.ok) {
    const error = await response.json();
    console.error("Error:", error);
    return;
  }

  const buffer = Buffer.from(await response.arrayBuffer());
  fs.writeFileSync("compressed.jpg", buffer);
  console.log("Compressed image saved as compressed.jpg");
}

compressImage();

الخطوات التالية

المصادقة -- تعرّف على مصادقة API Key بالتفصيل.

مرجع API: أدوات الصور -- استكشف جميع نقاط وصول معالجة الصور.

مرجع API: أدوات PDF -- استكشف جميع نقاط وصول معالجة PDF.

أمثلة الكود -- أمثلة جاهزة للاستخدام بعدة لغات.