RESTful API (Representational State Transfer Application Programming Interface) telah menjadi standar de facto untuk komunikasi antar sistem. RESTful API memungkinkan aplikasi frontend (web atau mobile) untuk berinteraksi dengan backend untuk mengambil, membuat, memperbarui, dan menghapus data.

Express.js adalah framework web minimalis dan fleksibel untuk Node.js yang sangat populer untuk membangun API RESTful. Dengan sintaksis yang sederhana dan ekosistem middleware yang kaya, Express.js mempercepat proses pengembangan backend secara signifikan.

Artikel ini akan memandu Anda langkah demi langkah dalam membangun RESTful API sederhana menggunakan Express.js, mencakup konsep-konsep inti seperti routing, middleware, dan penanganan permintaan HTTP. Mari kita mulai membuat API pertama Anda!

Mengapa Memilih Express.js untuk RESTful API?

Ada beberapa alasan mengapa Express.js adalah pilihan populer untuk membangun RESTful API:

• Minimalis dan Fleksibel: Express.js tidak memaksakan struktur tertentu, memberikan kebebasan penuh kepada developer untuk mengatur proyek mereka.
• Ringan dan Cepat: Berjalan di atas V8 JavaScript Engine Node.js, Express.js sangat efisien dan memiliki overhead yang rendah.
• Ekosistem Middleware yang Kaya: Ribuan middleware pihak ketiga tersedia untuk menangani berbagai tugas seperti parsing body permintaan, otentikasi, logging, dan validasi.
• Skalabilitas: Mampu menangani banyak permintaan konkuren karena sifat non-blocking I/O Node.js.
• Komunitas Besar: Memiliki komunitas yang aktif, dokumentasi yang melimpah, dan banyak sumber daya belajar.

Konsep Dasar RESTful API

Sebelum melangkah ke kode, pahami prinsip dasar REST:

• Resources (Sumber Daya): Setiap "hal" yang dapat diakses oleh API (misalnya, pengguna, produk, pesanan) dianggap sebagai sumber daya.
• URLs (Uniform Resource Locators): Setiap sumber daya diidentifikasi oleh URL yang unik (misalnya, /users, /products/123).
• HTTP Methods (Kata Kerja HTTP): Digunakan untuk melakukan operasi pada sumber daya:
  • GET: Mengambil/membaca sumber daya.
  • POST: Membuat sumber daya baru.
  • PUT: Memperbarui sumber daya yang sudah ada (mengganti secara keseluruhan).
  • PATCH: Memperbarui sebagian sumber daya yang sudah ada.
  • DELETE: Menghapus sumber daya.
• Stateless: Setiap permintaan dari klien ke server harus berisi semua informasi yang dibutuhkan server untuk memahami permintaan tersebut. Server tidak menyimpan informasi state dari permintaan sebelumnya.
• Representation: Data dikirim dalam format standar seperti JSON (JavaScript Object Notation) atau XML. JSON adalah yang paling umum.

Memulai Proyek Express.js

Mari kita buat API sederhana untuk mengelola daftar buku.

Langkah 1: Inisialisasi Proyek

Buat folder baru untuk proyek Anda, lalu buka terminal di dalam folder tersebut dan inisialisasi proyek Node.js:

Bash

mkdir book-api
cd book-api
npm init -y

Perintah npm init -y akan membuat file package.json dengan konfigurasi default.

Langkah 2: Instal Express.js

Instal Express.js sebagai dependensi proyek Anda:

Bash

npm install express

Langkah 3: Buat File Server Utama

Buat file bernama app.js (atau server.js) di dalam folder proyek Anda:

JavaScript

// app.js

// 1. Import library Express
const express = require('express');
const app = express(); // Membuat instance aplikasi Express

// Port server akan berjalan
const PORT = process.env.PORT || 3000;

// 2. Middleware untuk parsing JSON body
// Ini penting agar Express bisa membaca data yang dikirim dalam format JSON
app.use(express.json());

// Data dummy untuk simulasi database
let books = [
  { id: 1, title: 'The Lord of the Rings', author: 'J.R.R. Tolkien' },
  { id: 2, title: 'The Hobbit', author: 'J.R.R. Tolkien' },
  { id: 3, title: 'Pride and Prejudice', author: 'Jane Austen' }
];

// --- ROUTES (ENDPOINT API) ---

// 3. GET all books
// Endpoint: GET /api/books
app.get('/api/books', (req, res) => {
  res.json(books); // Mengirim semua data buku dalam format JSON
});

// 4. GET a single book by ID
// Endpoint: GET /api/books/:id
app.get('/api/books/:id', (req, res) => {
  const bookId = parseInt(req.params.id); // Ambil ID dari parameter URL, konversi ke integer
  const book = books.find(b => b.id === bookId); // Cari buku berdasarkan ID

  if (book) {
    res.json(book); // Jika buku ditemukan, kirim data buku
  } else {
    res.status(404).json({ message: 'Book not found' }); // Jika tidak, kirim status 404 (Not Found)
  }
});

// 5. POST a new book
// Endpoint: POST /api/books
app.post('/api/books', (req, res) => {
  const newBook = req.body; // Ambil data buku baru dari body permintaan
  
  // Validasi sederhana: pastikan ada title dan author
  if (!newBook.title || !newBook.author) {
    return res.status(400).json({ message: 'Title and author are required' });
  }

  // Beri ID unik (simulasi auto-increment)
  newBook.id = books.length > 0 ? Math.max(...books.map(b => b.id)) + 1 : 1;
  books.push(newBook); // Tambahkan buku baru ke array
  res.status(201).json(newBook); // Kirim kembali buku yang baru dibuat dengan status 201 (Created)
});

// 6. PUT (Update) an existing book by ID
// Endpoint: PUT /api/books/:id
app.put('/api/books/:id', (req, res) => {
  const bookId = parseInt(req.params.id);
  const updatedBook = req.body;
  
  let bookIndex = books.findIndex(b => b.id === bookId); // Cari indeks buku

  if (bookIndex !== -1) {
    // Perbarui buku yang ada dengan data dari permintaan
    books[bookIndex] = { ...books[bookIndex], ...updatedBook, id: bookId };
    res.json(books[bookIndex]); // Kirim buku yang sudah diperbarui
  } else {
    res.status(404).json({ message: 'Book not found' });
  }
});

// 7. DELETE a book by ID
// Endpoint: DELETE /api/books/:id
app.delete('/api/books/:id', (req, res) => {
  const bookId = parseInt(req.params.id);
  
  const initialLength = books.length;
  books = books.filter(b => b.id !== bookId); // Filter buku yang akan dihapus

  if (books.length < initialLength) {
    res.status(204).send(); // Kirim status 204 (No Content) jika berhasil dihapus
  } else {
    res.status(404).json({ message: 'Book not found' });
  }
});

// 8. Start the server
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
  console.log(`Access API at http://localhost:${PORT}/api/books`);
});

Penjelasan Kode app.js:

1. require('express'): Mengimpor modul Express.js.
2. app.use(express.json()): Ini adalah middleware penting. Middleware ini memberitahu Express untuk mengurai body permintaan yang masuk dalam format JSON. Tanpa ini, req.body akan menjadi undefined.
3. let books = [...]: Ini adalah array JavaScript sederhana yang berfungsi sebagai "database" sementara kita. Dalam aplikasi nyata, Anda akan berinteraksi dengan database sungguhan (misalnya MongoDB, PostgreSQL, MySQL).
4. app.get('/api/books', ...): Ini mendefinisikan route untuk mengambil semua buku. Ketika ada permintaan GET ke /api/books, callback function akan dieksekusi, dan mengirimkan array books sebagai respons JSON.
5. app.get('/api/books/:id', ...): Ini adalah route untuk mengambil buku berdasarkan ID. :id adalah parameter URL. req.params.id digunakan untuk mengakses nilai ID tersebut. parseInt() digunakan karena parameter URL selalu berupa string.
6. app.post('/api/books', ...): Ini adalah route untuk membuat buku baru. Data buku baru diambil dari req.body. Setelah divalidasi dan diberi ID, buku ditambahkan ke array books, dan respons 201 Created dikirim.
7. app.put('/api/books/:id', ...): Ini adalah route untuk memperbarui buku yang sudah ada. Menggunakan findIndex() untuk menemukan indeks buku yang akan diperbarui, lalu menggabungkan data lama dengan data baru dari req.body menggunakan spread operator (...).
8. app.delete('/api/books/:id', ...): Ini adalah route untuk menghapus buku. Menggunakan filter() untuk membuat array baru tanpa buku yang dihapus. Jika penghapusan berhasil, respons 204 No Content dikirim.
9. app.listen(PORT, ...): Ini memulai server Express dan membuatnya mendengarkan permintaan pada port yang ditentukan (3000 secara default).

Menjalankan API Anda

Untuk menjalankan API Anda, buka terminal di folder proyek dan jalankan perintah:

Bash

node app.js

Anda akan melihat pesan di konsol yang menunjukkan bahwa server sedang berjalan.

Menguji API Anda

Anda bisa menguji API menggunakan tool seperti Postman, Insomnia, atau ekstensi browser seperti Thunder Client (untuk VS Code), atau bahkan langsung dari browser untuk permintaan GET.

Contoh Permintaan:

• GET All Books:

  • Method: GET
  • URL: http://localhost:3000/api/books
  • Response: [{"id":1,"title":"The Lord of the Rings", ...}]

• GET Single Book:

  • Method: GET
  • URL: http://localhost:3000/api/books/1
  • Response: {"id":1,"title":"The Lord of the Rings", "author":"J.R.R. Tolkien"}

• POST New Book:

  • Method: POST
  • URL: http://localhost:3000/api/books
  • Headers: Content-Type: application/json
  • Body (raw JSON): JSON

    {
      "title": "The Hitchhiker's Guide to the Galaxy",
      "author": "Douglas Adams"
    }
    

  • Response: {"title":"The Hitchhiker's Guide to the Galaxy", "author":"Douglas Adams", "id":4} (dengan status 201 Created)

• PUT Update Book:

  • Method: PUT
  • URL: http://localhost:3000/api/books/4
  • Headers: Content-Type: application/json
  • Body (raw JSON): JSON

    {
      "title": "The Ultimate Hitchhiker's Guide",
      "author": "Douglas Adams"
    }
    

  • Response: {"id":4,"title":"The Ultimate Hitchhiker's Guide", "author":"Douglas Adams"}

• DELETE Book:

  • Method: DELETE
  • URL: http://localhost:3000/api/books/4
  • Response: (No Content, status 204)

Langkah Selanjutnya (Produksi dan Fitur Lanjut)

API sederhana ini adalah titik awal yang baik. Untuk API yang siap produksi, Anda perlu mempertimbangkan hal-hal berikut:

• Database Nyata: Ganti array data dummy dengan koneksi ke database sungguhan (MongoDB dengan Mongoose, PostgreSQL dengan Sequelize/Prisma, dll.).
• Error Handling: Implementasikan penanganan error yang lebih robust untuk menangkap dan merespons error dengan elegan.
• Validasi Input: Gunakan library seperti Joi atau Express-Validator untuk validasi input yang lebih canggih.
• Autentikasi dan Otorisasi: Amankan API Anda dengan menambahkan lapisan autentikasi (misalnya, JWT - JSON Web Tokens) dan otorisasi.
• Routing Terpisah: Untuk aplikasi yang lebih besar, pisahkan routes ke dalam file terpisah untuk menjaga kode tetap terorganisir.
• Logging: Tambahkan logging untuk memantau aktivitas API dan debugging.
• CORS (Cross-Origin Resource Sharing): Jika frontend Anda di-hosting di domain yang berbeda, Anda perlu mengonfigurasi CORS.
• Deployment: Host API Anda di cloud platform seperti Heroku, Vercel, AWS, Google Cloud, atau DigitalOcean.

Cara Yang Efisien

Membangun RESTful API dengan Express.js adalah cara yang efisien dan efektif untuk menyediakan layanan backend untuk aplikasi frontend Anda. Dengan pemahaman tentang konsep RESTful, penggunaan middleware dasar seperti express.json(), dan definisi route yang tepat, Anda dapat dengan cepat membuat API yang fungsional.

Express.js, dengan kesederhanaan dan fleksibilitasnya, tetap menjadi pilihan utama bagi developer Node.js yang ingin membangun API yang cepat, scalable, dan mudah dipelihara. Sekarang, Anda memiliki dasar untuk mulai membangun API Anda sendiri dan mengintegrasikannya dengan aplikasi web atau mobile!