API (Application Programming Interface) adalah jembatan yang memungkinkan komunikasi antara aplikasi perangkat lunak. Salah satu jenis API yang populer digunakan adalah API RESTful. Dalam artikel ini, kita akan membahas cara membangun API RESTful menggunakan Node.js dan Express, khusus untuk pemula.

Apa itu API RESTful?

REST (Representational State Transfer) adalah gaya arsitektur yang sering digunakan dalam pengembangan API. API RESTful mematuhi prinsip-prinsip REST, seperti:

• Stateless: Setiap permintaan dari klien ke server harus berisi semua informasi yang dibutuhkan untuk memahami permintaan tersebut.
• HTTP Methods: Menggunakan metode HTTP seperti GET, POST, PUT, dan DELETE untuk operasi CRUD (Create, Read, Update, Delete).
• Resource-Based: Setiap URL mewakili sebuah sumber daya (resource).

Persiapan: Instalasi Node.js dan Express

Sebelum mulai membangun API, pastikan Anda sudah menginstal Node.js di komputer Anda. Anda bisa mengunduhnya dari Node.js Official Website. Setelah Node.js terinstal, buat direktori baru untuk proyek API Anda:

mkdir api-restful
cd api-restful

Setelah itu, inisialisasi proyek Node.js dengan perintah berikut:

npm init -y

Ini akan membuat file package.json, yang berisi informasi proyek dan dependensi.

Instalasi Express

Untuk membuat API dengan Node.js, kita akan menggunakan Express, sebuah framework minimalis yang populer untuk pengembangan server Node.js. Instal Express dengan perintah berikut:

npm install express

Membuat Struktur Dasar API

Buat file server.js sebagai entry point aplikasi kita. Di dalam file ini, kita akan mengonfigurasi server Express:

// server.js
const express = require('express');
const app = express();
const PORT = 3000;

// Middleware untuk parsing JSON
app.use(express.json());

// Route dasar
app.get('/', (req, res) => {
  res.send('Selamat datang di API RESTful dengan Node.js dan Express');
});

// Menjalankan server
app.listen(PORT, () => {
  console.log(`Server berjalan di http://localhost:${PORT}`);
});

Pada kode di atas, kita membuat server Express yang berjalan pada port 3000 dan memiliki satu route dasar untuk menampilkan pesan.
Menambahkan Operasi CRUD

Sekarang, kita akan menambahkan endpoint untuk melakukan operasi CRUD pada resource users.

• GET: Mendapatkan semua user.
• POST: Menambahkan user baru.
• PUT: Mengubah user yang sudah ada.
• DELETE: Menghapus user.

Mari kita mulai dengan membuat array sederhana sebagai database sementara:

// Simulasi database
let users = [
  { id: 1, name: 'John Doe', email: 'john@example.com' },
  { id: 2, name: 'Jane Doe', email: 'jane@example.com' }
];

Kemudian, tambahkan route untuk setiap operasi:

// GET: Mendapatkan semua user
app.get('/users', (req, res) => {
  res.json(users);
});

// POST: Menambahkan user baru
app.post('/users', (req, res) => {
  const newUser = {
    id: users.length + 1,
    name: req.body.name,
    email: req.body.email
  };
  users.push(newUser);
  res.status(201).json(newUser);
});

// PUT: Mengubah data user
app.put('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const user = users.find(u => u.id === userId);
  
  if (user) {
    user.name = req.body.name;
    user.email = req.body.email;
    res.json(user);
  } else {
    res.status(404).send('User tidak ditemukan');
  }
});

// DELETE: Menghapus user
app.delete('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  users = users.filter(u => u.id !== userId);
  res.status(204).send();
});

Penjelasan singkat dari kode di atas:

• GET /users: Mengembalikan semua user dalam bentuk JSON.
• POST /users: Menambahkan user baru berdasarkan data yang dikirimkan dalam body request.
• PUT /users/: Mengubah data user berdasarkan id yang dikirim di URL.
• DELETE /users/: Menghapus user berdasarkan id.

Menjalankan dan Menguji API

Jalankan server menggunakan perintah berikut:

node server.js

API Anda sekarang berjalan di http://localhost:3000. Untuk menguji setiap endpoint, Anda bisa menggunakan aplikasi Postman atau cURL.

Berikut contoh menggunakan cURL untuk menguji GET:

curl http://localhost:3000/users

Kesimpulan

Membangun API RESTful dengan Node.js dan Express sangatlah sederhana dan cepat. Dengan mengikuti tutorial ini, Anda telah mempelajari cara membuat server Express, menambahkan operasi CRUD, dan menjalankan API.

Jika Anda ingin mengembangkan API lebih lanjut, Anda bisa mempertimbangkan untuk menggunakan database seperti MongoDB atau MySQL, serta menambahkan fitur seperti validasi input dan autentikasi.