إدارة API Key
تعرّف على كيفية إنشاء وإدارة وتأمين مفاتيح FreeFileTools API.
إنشاء API Key
لإنشاء API Key:
- سجّل الدخول إلى حسابك في freefiletools.io
- انتقل إلى لوحة التحكم > API Keys
- انقر على إنشاء API Key
- أعطِ مفتاحك اسمًا وصفيًا (مثال: "تطبيقي"، "خط أنابيب CI")
- انسخ واحفظ المفتاح بأمان -- سيُعرض مرة واحدة فقط
سيبدو مفتاحك كالتالي: fft_abc123def456...
الخطة المجانية
| الميزة | الحد |
|---|---|
| عدد مفاتيح API لكل حساب | 1 |
| الطلبات في الساعة | 50 |
| الحد الأقصى لحجم الملف | 25 MB |
| جميع نقاط الوصول | مُتضمّنة |
إعادة توليد المفتاح
إذا تم اختراق API Key أو كنت بحاجة لمفتاح جديد:
- اذهب إلى لوحة التحكم > API Keys
- انقر على زر إعادة التوليد بجوار مفتاحك الحالي
- أكّد العملية -- سيتم إبطال مفتاحك القديم فورًا
- انسخ واحفظ المفتاح الجديد
تحذير: إعادة توليد المفتاح تُبطل المفتاح القديم فورًا. أي تطبيقات تستخدم المفتاح القديم ستتوقف عن العمل حتى يتم تحديثها بالمفتاح الجديد.
أفضل ممارسات الأمان
1.
لا تشارك API Key أبدًا
لا تشارك مفتاحك في المستودعات العامة أو المنتديات أو الكود من جانب العميل.
2.
استخدم متغيرات البيئة
خزّن API Key في متغيرات البيئة، وليس في الكود المصدري.
3.
أبقِه من جانب الخادم
أجرِ استدعاءات API من خادمك الخلفي. لا تكشف المفتاح أبدًا في JavaScript الأمامي.
4.
أعد التوليد إذا تم الاختراق
إذا كان من المحتمل أن مفتاحك قد تم كشفه، أعد توليده فورًا من لوحة التحكم.
مثال: استخدام متغيرات البيئة
bash
# .env file (do NOT commit this)
FFT_API_KEY=fft_your_api_key_herejavascript
// 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,
});