بناء API وأفضل الممارسات

import express from "express";
const app = express();
app.use(express.json());

let users = [{ id: 1, name: "براء" }];

// جلب الكل
app.get("/users", (req, res) => {
  res.json(users);
});

// جلب واحد
app.get("/users/:id", (req, res) => {
  const user = users.find((u) => u.id == req.params.id);
  if (!user) return res.status(404).json({ error: "غير موجود" });
  res.json(user);
});

// إنشاء
app.post("/users", (req, res) => {
  const user = { id: Date.now(), ...req.body };
  users.push(user);
  res.status(201).json(user);
});

app.listen(3000);

/api/v1/users
/api/v2/users

✅ HTTPS دائمًا
✅ مصادقة (API keys أو JWT tokens)
✅ تحقّق من المدخلات (validation)
✅ تحديد معدّل الطلبات (Rate Limiting)
✅ لا تكشف تفاصيل الأخطاء الداخلية

GET /users?page=2&limit=20
GET /users?role=admin&sort=name