API vs Middleware: Memahami Perbezaan

Apabila mengusahakan pembangunan bahagian belakang, dua istilah yang anda pasti akan hadapi ialah API dan Perisian Tengah.

Walaupun kedua-duanya memainkan peranan penting dalam seni bina aplikasi, ia mempunyai tujuan yang sangat berbeza.

Mari kita pecahkan mereka, bandingkan peranan mereka dan jelaskan perbezaan mereka dengan cara yang tidak akan membuatkan anda mahu menyelak meja anda.

Apakah API?

API adalah singkatan kepada Antara Muka Pengaturcaraan Aplikasi. Ia pada asasnya adalah kontrak yang membenarkan komponen perisian yang berbeza untuk bercakap antara satu sama lain.

Anggaplah ia sebagai pelayan di restoran: ia mengambil pesanan anda (permintaan), menghantarnya ke dapur (pelayan) dan membawa balik makanan anda (tindak balas).

Ciri-ciri Utama API

• Mendedahkan titik akhir untuk berinteraksi dengan data atau perkhidmatan.
• Beroperasi melalui HTTP/HTTPS (paling biasa untuk API web).
• Boleh mengikut protokol seperti REST, GraphQL atau gRPC.

Analogi Dunia Sebenar

Anda menggunakan API setiap kali anda memesan Uber atau menyiarkan tweet. Bahagian belakang apl menyediakan API untuk bahagian hadapan untuk mengambil atau menghantar data.

• Contoh Kod Begini rupa titik akhir API mudah dalam apl Express.js:

  const express = require('express');
  const app = express();

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

• API mentakrifkan apa fungsi apl anda dedahkan kepada dunia luar.

Apakah Middleware?

Perisian tengah lebih seperti kakitangan di belakang tabir di dapur—ia bukan yang melayani anda secara langsung, tetapi ia memastikan semuanya berjalan lancar.

Dalam istilah teknikal, middleware ialah fungsi atau set fungsi yang terletak di antara permintaan dan respons dalam saluran paip aplikasi anda.

Ciri-ciri Utama Middleware

• Memproses permintaan sebelum ia mencapai pengendali terakhir (mis., API).
• Boleh mengubah suai permintaan atau respons.
• Selalunya digunakan untuk tugas seperti pengesahan, pengelogan, pengesahan atau pengendalian ralat.

Analogi Dunia Sebenar

Fikirkan middleware sebagai pengawal keselamatan dalam bangunan.

Ia memastikan bahawa hanya individu yang diberi kuasa (permintaan yang sah) boleh masuk ke pejabat (API).

• Contoh Kod Berikut ialah contoh perisian tengah pengelogan mudah dalam Express.js:

  const express = require('express');
  const app = express();

  const loggingMiddleware = (req, res, next) => {
    console.log(`Request made to: ${req.url}`);
    next(); // Pass control to the next middleware or handler
  };

  app.use(loggingMiddleware);

  app.get('/users', (req, res) => {
    res.json([
      { id: 1, name: 'John Doe' },
      { id: 2, name: 'Jane Smith' },
    ]);
  });

  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });

• Perisian tengah mengendalikan cara permintaan diproses sebelum ia mencapai titik akhir.

Perbezaan Utama Antara API dan Middleware

Aspect	API	Middleware
Purpose	Defines endpoints for interaction.	Processes requests/responses.
Visibility	Exposed to external systems.	Works internally within the app.
Examples	/users, /products, /login	Authentication, logging, error handling
Interaction	Invoked by external clients.	Invoked automatically in the request pipeline.
Code Placement	Found in controllers.	Found in the middleware functions.

Bila Menggunakan API vs Middleware

• API

  • Gunakan API apabila anda ingin menyediakan cara untuk aplikasi atau perkhidmatan luaran berinteraksi dengan sistem anda.
  • Contoh: Apl mudah alih yang mengambil butiran pengguna melalui /users/:id.

• Perisian Tengah

  • Gunakan perisian tengah untuk merentasi kebimbangan yang berkaitan dengan berbilang laluan atau API.
  • Contoh: Mengesahkan token JWT untuk semua laluan yang dilindungi, menetapkan kuki dalam penyemak imbas.

Membawanya Bersama

Bayangkan membina apl perkongsian perjalanan. API mungkin termasuk:

• /drivers: Untuk mengambil pemandu yang tersedia.
• /trips: Untuk menempah atau mengurus perjalanan.

Di sebalik tabir, middleware memastikan:

• Hanya pengguna yang disahkan boleh mengakses /trips.
• Log disimpan untuk setiap permintaan.
• Penghadan kadar dikuatkuasakan untuk mengelakkan penyalahgunaan.

Kedua-dua API dan perisian tengah amat diperlukan dalam menghasilkan aplikasi yang mantap—satu mendedahkan kefungsian dan satu lagi memastikan ia berfungsi dengan lancar dan selamat.

Bercakap tentang API,

Saya telah mengusahakan alat yang sangat mudah yang dipanggil LiveAPI.

Ia direka untuk menjadikan dokumentasi API mudah untuk pembangun.

Dengan LiveAPI, anda boleh menjana dokumentasi API interaktif dengan cepat yang membolehkan pengguna melaksanakan API terus daripada penyemak imbas.

Jika anda bosan membuat dokumen secara manual atau tidak mahu meluangkan masa untuk menyepadukan kesombongan untuk API anda, alat ini mungkin menjadikan hidup anda lebih mudah, cuba LiveAPI sekarang!

Atas ialah kandungan terperinci API vs Middleware: Memahami Perbezaan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!