مفاتيح API
جميع نقاط v1 تتطلب مفتاح API في ترويسةx-api-key.
إنشاء مفاتيح API
- سجّل الدخول إلى لوحة AFKCrypto
- انتقل إلى قسم API Keys
- انقر “Generate API Key”
- امنح المفتاح اسمًا وصفيًا
- اختياري: عيّن مدة انتهاء (7 أيام، 30 يومًا، 90 يومًا، 180 يومًا أو سنة)
- انسخ المفتاح فورًا — لن يُعرض مرة أخرى
تنسيق المفتاح
- Prefix: معرّف من 4 أحرف للعثور السريع
- Random: سلسلة عشوائية بطول 32 حرفًا آمنة تشفيريًا
استخدام مفاتيح API
أدرج المفتاح في كل طلب ضمن ترويسةx-api-key:
أفضل ممارسات الأمان
- لا تُدرج مفاتيح API في نظام التحكم بالإصدارات — استخدم متغيرات البيئة
- دوّر المفاتيح بانتظام — استخدم الانتهاء للوصول المؤقت
- استخدم مفاتيح منفصلة لكل بيئة — التطوير، الاختبار، الإنتاج
- ألغِ فورًا المفاتيح غير المستخدمة — لتقليل سطح الهجوم
- خزّنها بأمان — استخدم مدير أسرار (مثل AWS Secrets Manager أو HashiCorp Vault)
انتهاء صلاحية المفتاح
يمكن لمفاتيح API أن تنتهي صلاحيتها بعد مدة محددة:- لا تنتهي (افتراضيًا): تعمل حتى الإلغاء
- 7 أيام: اختبار/عروض قصيرة المدى
- 30 يومًا: وصول المتعاقدين أو التجارب
- 90 يومًا: تدوير فصلي موصى به
- 180 يومًا: تدوير نصف سنوي
- سنة واحدة: تدوير سنوي للتكاملات المستقرة
- تعيد الطلبات بهذا المفتاح HTTP 401
UNAUTHORIZED - يبقى المفتاح ظاهرًا في اللوحة للأغراض التدقيقية
- أنشئ مفتاحًا جديدًا لاستبداله
- تعرض اللوحة الحالة “Expired” أو “Expiring soon” (≤ 7 أيام)
- اضبط التنبيهات لتجنّب الانقطاع
حدود المفاتيح
- أقصى عدد مفاتيح نشطة: 10 لكل مستخدم
- تُطبّق حدود المعدّل: راجع Rate limiting
- ألغِ المفاتيح غير المستخدمة للبقاء ضمن الحد
إلغاء مفاتيح API
ألغِ المفتاح فورًا عبر اللوحة:- افتح API Keys
- اعثر على المفتاح المراد إلغاؤه
- انقر “Revoke Key”
- أكّد الإجراء