قد تبدو خطوة بناء أول سيرفر أو خلفية برمجية (Backend) صعبة في البداية، ولكن باستخدام Node.js وإطار العمل Express، يمكنك إطلاق أول واجهة برمجة تطبيقات (REST API) سريعة وقوية خلال دقائق معدودة.

1. المتطلبات الأساسية

قبل البدء في كتابة الكود، تأكد من تثبيت الأدوات التالية على جهازك:

  • بيئة التشغيل Node.js ومدير الحزم npm
  • محرر أكواد مثل VS Code
  • أداة لاختبار الـ APIs مثل Postman أو إضافة Thunder Client

2. تجهيز وتهيئة المشروع

أنشئ مجلداً جديداً لمشروعك وقم بتهيئته لإنشاء ملف package.json:

mkdir my-first-backend
cd my-first-backend
npm init -y

3. تثبيت إطار العمل Express

قم بتثبيت حزمة Express.js التي تسهل إدارة المسارات والطلبات البرمجية:

npm install express

4. كتابة كود السيرفر الأساسي

أنشئ ملفاً جديداً باسم index.js وأضف الكود التالي لتشغيل الخادم وإنشاء المسارات الأساسية:

const express = require('express');
const app = express();
const PORT = 3000;
// وسيط (Middleware) لمعالجة البيانات القادمة بصيغة JSON
app.use(express.json());


// المسار الرئيسي للتحقق من عمل الخادم
app.get('/', (req, res) => {
  res.json({ message: 'مرحباً بك في أول سيرفر Node.js خاص بي!' });
});


// مسار لجلب قائمة تجريبية
app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: 'أحمد', role: 'مطور واجهات' },
    { id: 2, name: 'سارة', role: 'مصممة واجهات' }
  ];
  res.status(200).json(users);
});


// تشغيل الخادم على المنفذ المحدد
app.listen(PORT, () => {
  console.log(السيرفر يعمل الآن على: http://localhost:${PORT});
});

5. تشغيل واختبار السيرفر

شغّل السيرفر عبر منفذ الأوامر (Terminal):

node index.js

افتح المتصفح أو تطبيق Postman وتوجه إلى الرابط http://localhost:3000/api/users وستصلك استجابة الـ JSON بنجاح.