كيفية بناء واجهة REST API باستخدام Node.js و Express

mkdir my-api && cd my-api
npm init -y
npm install express dotenv
npm install --save-dev nodemon

# سنضيف scripts إلى package.json في الخطوة التالية

{
  "name": "my-api",
  "version": "1.0.0",
  "main": "src/app.js",
  "scripts": {
    "start": "node src/app.js",
    "dev": "nodemon src/app.js"
    // بديل حديث — لا حاجة لـ nodemon:
    // "dev": "node --watch src/app.js"
  },
  "dependencies": {
    "dotenv": "^16.0.0",
    "express": "^4.18.0"
  },
  "devDependencies": {
    "nodemon": "^3.0.0"
  }
}

// src/app.js
require("dotenv").config()
const express = require("express")
const usersRouter = require("./routes/users")

const app = express()
const PORT = process.env.PORT || 3000

// Middleware
app.use(express.json())

// Routes
app.use("/api/users", usersRouter)

// احتياطي 404
app.use((req, res) => {
  res.status(404).json({ error: "Not found" })
})

// معالج أخطاء مركزي
app.use((err, req, res, next) => {
  console.error(err.stack)
  res.status(500).json({ error: "Internal server error" })
})

app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`)
})

module.exports = app

// src/routes/users.js
const express = require("express")
const router = express.Router()
const usersController = require("../controllers/usersController")

router.get("/", usersController.getAll)
router.get("/:id", usersController.getOne)
router.post("/", usersController.create)
router.put("/:id", usersController.update)
router.delete("/:id", usersController.remove)

module.exports = router

// src/controllers/usersController.js
let users = [
  { id: 1, name: "Alice", email: "alice@example.com" },
  { id: 2, name: "Bob", email: "bob@example.com" },
]
let nextId = 3

exports.getAll = (req, res) => {
  res.json(users)
}

exports.getOne = (req, res) => {
  const user = users.find((u) => u.id === Number(req.params.id))
  if (!user) return res.status(404).json({ error: "User not found" })
  res.json(user)
}

exports.create = (req, res) => {
  const { name, email } = req.body
  if (!name || !email) {
    return res.status(400).json({ error: "name and email are required" })
  }
  const user = { id: nextId++, name, email }
  users.push(user)
  res.status(201).json(user)
}

exports.update = (req, res) => {
  const index = users.findIndex((u) => u.id === Number(req.params.id))
  if (index === -1) return res.status(404).json({ error: "User not found" })
  users[index] = { ...users[index], ...req.body, id: users[index].id }
  res.json(users[index])
}

exports.remove = (req, res) => {
  const index = users.findIndex((u) => u.id === Number(req.params.id))
  if (index === -1) return res.status(404).json({ error: "User not found" })
  users.splice(index, 1)
  res.status(204).send()
}

npm run dev

# عرض جميع المستخدمين
curl http://localhost:3000/api/users

# جلب مستخدم واحد
curl http://localhost:3000/api/users/1

# إنشاء مستخدم
curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{"name":"Carol","email":"carol@example.com"}'

# تحديث مستخدم
curl -X PUT http://localhost:3000/api/users/3 \
  -H "Content-Type: application/json" \
  -d '{"name":"Caroline"}'

# حذف مستخدم
curl -X DELETE http://localhost:3000/api/users/3

src/
├── app.js            # نقطة دخول — تشغيل Express وتركيب routers
├── routes/
│   ├── users.js      # تعريفات routes لـ /api/users
│   └── posts.js      # تعريفات routes لـ /api/posts
├── controllers/
│   ├── usersController.js
│   └── postsController.js
├── models/           # طبقة الوصول لقاعدة البيانات (استعلامات، ORM)
│   ├── User.js
│   └── Post.js
├── middleware/
│   ├── auth.js       # التحقق من JWT
│   └── validate.js   # مُغلّف التحقق من المدخلات
└── config/
    └── db.js         # إعداد اتصال قاعدة البيانات