طراحی API مقیاس‌پذیر — الگوها و ملاحظات عملی

خلاصه: این نوشته الگوهای عملی برای ساخت APIهای HTTP را بررسی می‌کند — از هندلینگ درخواست و مدل‌سازی داده تا کشینگ، ناظرپذیری و استقرار. همراه با مثال‌های کوچک قابل اجرا.

اهداف

1. ساده و قابل‌پیش‌بینی نگه داشتن API.
2. پیش‌فرض‌سازی امنیت و ناظرپذیری (timeoutها، محدودیت نرخ، متریک‌ها).
3. طراحی برای رشد تدریجی — ابتدا ساده شروع کنید و گلوگاه‌ها را وقتی ظاهر شدند رفع کنید.

۱ — انتخاب سطح سرویس

• REST — مناسب CRUD و سازگاری عمومی.
• GraphQL — وقتی کلاینت‌ها نیاز به کوئری منعطف دارند.
• gRPC — برای سرویس‌های داخلی با بار بالا و تایپ قوی.

۲ — هندلینگ درخواست: timeout و لغو

همیشه timeout تعریف کنید و لغو (cancellation) را منتقل کنید. نبود timeout باعث قفل شدن کانکشن‌ها و افزایش تأخیرهای انتهایی می‌شود.

import Fastify from "fastify";
 
const server = Fastify({ logger: true });
 
server.get("/users/:id", async (req, reply) => {
  const user = await db.getUser(req.params.id, { signal: req.signal });
  return user;
});
 
server.listen({ port: 3000 });