واجهة برمجة RESTful API كاملة مع توثيق تفاعلي

واجهة برمجة تطبيقات RESTful مكتملة المزايا، تصلح كأساس لأي تطبيق ويب أو موبايل، مع أفضل الممارسات المطبّقة فعلياً لا نظرياً.

لماذا هذا المشروع؟

أغلب الدروس تعلّمك بناء API بسيط، لكنها تتجاهل ما يجعله جاهزاً للإنتاج: الأمان، والأداء، والتوثيق، ومعالجة الأخطاء. هذا المشروع يغطّيها كلها.

المميزات الكاملة

• مصادقة JWT: تسجيل وتسجيل دخول مع توكنات تنتهي وتتجدد تلقائياً (Access + Refresh tokens).
• صلاحيات متدرجة (RBAC): أدوار مختلفة (مسؤول، محرر، مستخدم) بصلاحيات مخصصة.
• تحديد معدل الطلبات: حماية من إغراق الخادم بطلبات كثيرة (Rate Limiting).
• تصفية وترقيم: بحث وفلترة وترقيم النتائج بمعايير مرنة.
• رفع ملفات: رفع صور وملفات مع معالجة وتحقق آمن.
• سجل مراجعة: تسجيل كل العمليات لأغراض التدقيق.
• معالجة أخطاء شاملة: رسائل خطأ واضحة ومنظمة بصيغة JSON.
• توثيق Swagger: توثيق تفاعلي يتيح اختبار كل endpoint من المتصفح.

بنية المشروع

يتّبع نمط MVC معدّل: Controllers للمنطق، Services لقواعد العمل، Models لقاعدة البيانات، Middleware للحماية والتحقق. هذا الفصل يجعل الكود قابلاً للتوسع والاختبار.

التقنيات

Node.js مع Express.js كإطار عمل، MySQL لقاعدة البيانات، jsonwebtoken للمصادقة، express-rate-limit للحماية، و swagger-ui-express للتوثيق.

💡 هذا المشروع هو الأساس الذي تبني عليه أي تطبيق ويب أو موبايل — استثمر وقتك في فهمه جيداً وستوفّر أشهراً لاحقاً.