Node.js Backend Development Bootcamp · درس

تطبيق بوابة API

صمّموا بوابة API وأعدّوها لتكون نقطة الدخول الوحيدة لطلبات العملاء إلى خدماتكم المصغّرة

تطبيق بوابة API درس مجاني في Node.js Backend Development Bootcamp على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Node.js Backend Development Bootcamp، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Node.js Backend Development Bootcamp 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

API Gateway: The Front Door

In a microservices architecture, clients often need to interact with many different services. An API Gateway acts as a single, unified entry point for all client requests.

Think of it as the front desk of a large hotel. Instead of guests having to find specific rooms (microservices) themselves, they go to the front desk which directs them to the right place and handles common requests.

Why Use an API Gateway?

API Gateways solve several challenges that arise when using microservices:

Simplifies Clients: Clients only need to know one endpoint (the gateway) instead of many microservice URLs.
Request Routing: Directs incoming requests to the correct backend service.
Common Concerns: Handles cross-cutting concerns like authentication, rate limiting, and logging at a single point.
Service Aggregation: Can combine responses from multiple services into a single client-friendly response.

Gateway vs. Load Balancer

It's easy to confuse an API Gateway with a Load Balancer, but they serve different purposes:

Load Balancer: Operates at the network layer (Layer 4) or application layer (Layer 7) to distribute traffic across multiple instances of the same service for high availability and performance.
API Gateway: Operates at the application layer (Layer 7) and focuses on API-specific concerns. It routes requests to different services and can perform transformations or security checks.

They often work together, with a load balancer sitting in front of the API Gateway.

Key Responsibilities of a Gateway

An API Gateway takes on several crucial roles:

Request Routing: Mapping specific API paths (e.g., /users) to the appropriate microservice.
Authentication & Authorization: Verifying user identity and permissions before forwarding requests.
Rate Limiting: Controlling the number of requests a client can make within a certain timeframe.
Caching: Storing frequently accessed data to reduce load on backend services and improve response times.
Logging & Monitoring: Centralizing logs for all incoming requests and outgoing responses.

Building a Simple Gateway

You can build a custom API Gateway using Node.js and frameworks like Express.js. A popular library for proxying HTTP requests in Express is http-proxy-middleware.

This library makes it easy to forward requests from your gateway to your backend microservices, acting as a reverse proxy.

Basic Proxy Setup

Let's set up a simple Express.js server that acts as a proxy. This gateway will listen on port 3000 and forward all requests starting with /api to a mock 'users' microservice on port 3001.

Remember, for full functionality, you'd need an actual microservice running at http://localhost:3001.

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');

const app = express();
const GATEWAY_PORT = 3000;

// Proxy all requests starting with /api to the users microservice
app.use(
  '/api',
  createProxyMiddleware({
    target: 'http://localhost:3001', // Target URL of your users microservice
    changeOrigin: true, // Needed for virtual hosted sites
    logLevel: 'debug' // Optional: for seeing proxy activity in console
  })
);

// Simple root route for gateway status
app.get('/', (req, res) => {
  res.send('API Gateway is running. Try /api/users (if microservice is active).');
});

app.listen(GATEWAY_PORT, () => {
  console.log(`API Gateway listening on port ${GATEWAY_PORT}`);
  console.log('Proxying /api to http://localhost:3001');
});

Routing to Multiple Services

The power of an API Gateway comes from its ability to route requests to different microservices based on the request path, HTTP method, or other criteria.

You can define multiple proxy rules, each pointing to a different backend service. For example, /users goes to the user service, and /products goes to the product service.

Multi-Service Routing Example

Here, we extend our gateway to route requests for /users to a 'users-service' on port 3001 and requests for /products to a 'products-service' on port 3002.

The pathRewrite option is important: it removes the path prefix (e.g., /users) before forwarding the request to the target service.

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');

const app = express();
const GATEWAY_PORT = 3000;

// Proxy for user-related requests
app.use(
  '/users',
  createProxyMiddleware({
    target: 'http://localhost:3001', // Users Microservice URL
    changeOrigin: true,
    pathRewrite: { '^/users': '' }, // Remove /users prefix
    logLevel: 'debug'
  })
);

// Proxy for product-related requests
app.use(
  '/products',
  createProxyMiddleware({
    target: 'http://localhost:3002', // Products Microservice URL
    changeOrigin: true,
    pathRewrite: { '^/products': '' }, // Remove /products prefix
    logLevel: 'debug'
  })
);

app.get('/', (req, res) => {
  res.send('API Gateway is running. Try /users or /products (if microservices are active).');
});

app.listen(GATEWAY_PORT, () => {
  console.log(`API Gateway listening on port ${GATEWAY_PORT}`);
  console.log('Proxying /users to http://localhost:3001');
  console.log('Proxying /products to http://localhost:3002');
});

Centralized Middleware for Gateway

One of the biggest advantages of an API Gateway is applying middleware for common concerns before requests even reach your microservices.

You can implement Express middleware functions globally or for specific routes within your gateway to handle tasks like:

Authentication: Verify JWTs or session tokens.
Logging: Log every incoming request.
Rate Limiting: Prevent abuse by limiting request frequency.
Input Validation: Basic validation before forwarding.

Quick Check on Gateway

An API Gateway serves as a crucial component in a microservices setup. Let's test your understanding of its primary purpose.

Gateway Summary

You've learned about API Gateways, their importance in microservices, and how to implement a basic one using Express.js and http-proxy-middleware.

Key takeaways:

API Gateways simplify client interactions by providing a single entry point.
They handle routing, authentication, rate limiting, and other cross-cutting concerns.
Express.js with http-proxy-middleware is a flexible way to build custom gateways.

Mastering API Gateways is essential for building robust and scalable microservices!

الأسئلة الشائعة

هل درس «تطبيق بوابة API» مجاني؟

نعم — نص درس «تطبيق بوابة API» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Node.js Backend Development Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة Node.js Backend Development Bootcamp 4 دروس في المجموع.

ماذا ستتعلم في «تطبيق بوابة API»؟

صمّموا بوابة API وأعدّوها لتكون نقطة الدخول الوحيدة لطلبات العملاء إلى خدماتكم المصغّرة تتمرن على Node.js Backend Development Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Node.js Backend Development Bootcamp؟

لا تُشترط خبرة سابقة. Node.js Backend Development Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.

كم من الوقت يستغرق درس «تطبيق بوابة API»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Node.js Backend Development Bootcamp هذا؟

نعم. كل درس في Node.js Backend Development Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Node.js Backend Development Bootcamp