DocsAPI Keys

إدارة API Key

تعرّف على كيفية إنشاء وإدارة وتأمين مفاتيح FreeFileTools API.

إنشاء API Key

لإنشاء API Key:

  1. سجّل الدخول إلى حسابك في freefiletools.io
  2. انتقل إلى لوحة التحكم > API Keys
  3. انقر على إنشاء API Key
  4. أعطِ مفتاحك اسمًا وصفيًا (مثال: "تطبيقي"، "خط أنابيب CI")
  5. انسخ واحفظ المفتاح بأمان -- سيُعرض مرة واحدة فقط

سيبدو مفتاحك كالتالي: fft_abc123def456...

الخطة المجانية

الميزةالحد
عدد مفاتيح API لكل حساب1
الطلبات في الساعة50
الحد الأقصى لحجم الملف25 MB
جميع نقاط الوصولمُتضمّنة

إعادة توليد المفتاح

إذا تم اختراق API Key أو كنت بحاجة لمفتاح جديد:

  1. اذهب إلى لوحة التحكم > API Keys
  2. انقر على زر إعادة التوليد بجوار مفتاحك الحالي
  3. أكّد العملية -- سيتم إبطال مفتاحك القديم فورًا
  4. انسخ واحفظ المفتاح الجديد

تحذير: إعادة توليد المفتاح تُبطل المفتاح القديم فورًا. أي تطبيقات تستخدم المفتاح القديم ستتوقف عن العمل حتى يتم تحديثها بالمفتاح الجديد.

أفضل ممارسات الأمان

1.

لا تشارك API Key أبدًا

لا تشارك مفتاحك في المستودعات العامة أو المنتديات أو الكود من جانب العميل.

2.

استخدم متغيرات البيئة

خزّن API Key في متغيرات البيئة، وليس في الكود المصدري.

3.

أبقِه من جانب الخادم

أجرِ استدعاءات API من خادمك الخلفي. لا تكشف المفتاح أبدًا في JavaScript الأمامي.

4.

أعد التوليد إذا تم الاختراق

إذا كان من المحتمل أن مفتاحك قد تم كشفه، أعد توليده فورًا من لوحة التحكم.

مثال: استخدام متغيرات البيئة

bash
# .env file (do NOT commit this)
FFT_API_KEY=fft_your_api_key_here
javascript
// Read from environment variable
const apiKey = process.env.FFT_API_KEY;

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