Tutorial Membuat REST API Cepat dan Skalabel Menggunakan Node.js, Express, dan PostgreSQL

Di era pengembangan web modern, REST API (Representational State Transfer Application Programming Interface) menjadi tulang punggung yang menjembatani komunikasi antara sistem frontend (seperti React, Vue, atau aplikasi mobile) dengan server backend. Jika Anda saat ini sedang mencari panduan langkah demi langkah tentang cara membuat rest api node js yang tangguh, Anda berada di tempat yang sangat tepat.

Kombinasi antara Node.js (runtime JavaScript yang asinkron), Express.js (framework minimalis yang fleksibel), serta PostgreSQL (sistem database relasional open-source paling canggih) adalah tech-stack favorit banyak perusahaan teknologi. Node.js unggul berkat arsitektur non-blocking I/O-nya yang efisien, sedangkan PostgreSQL menawarkan integritas data yang luar biasa untuk skala perusahaan.

Mari kita mulai langkah-langkah praktisnya!

Prasyarat Lingkungan Pengembangan

Sebelum kita mulai menulis kode, pastikan lingkungan kerja (development environment) Anda sudah dilengkapi dengan beberapa hal berikut:

1. Node.js sudah terinstal di komputer atau laptop Anda (unduh versi LTS terbaru dari situs resminya).

2. PostgreSQL sudah terinstal dan berjalan. Anda bisa menggunakan pgAdmin untuk antarmuka GUI-nya.

3. Aplikasi pengujian API seperti Postman atau Insomnia.

4. Code Editor, sangat disarankan menggunakan Visual Studio Code (VS Code).

Langkah 1: Inisialisasi Proyek Node.js

Pertama, buat sebuah folder baru untuk menyimpan proyek Anda, kemudian buka melalui terminal atau command prompt. Kita akan menginisialisasi proyek untuk membuat file package.json.

Jalankan perintah berikut di terminal:

Bash

mkdir node-postgres-api
cd node-postgres-api
npm init -y

 

Selanjutnya, kita perlu menginstal dependensi utama proyek ini: express untuk membuat server, pg untuk mengkoneksikan Node.js ke PostgreSQL, dan dotenv untuk menyembunyikan variabel kredensial yang sensitif.

Bash

npm install express pg dotenv

Langkah 2: Menyiapkan Database PostgreSQL

Buka terminal SQL Anda (psql) atau gunakan tool antarmuka GUI seperti pgAdmin. Buatlah sebuah database baru, misalnya dengan nama bookstore.

SQL

CREATE DATABASE bookstore;

 Setelah database terbuat dan Anda sudah masuk (terhubung) ke database tersebut, jalankan perintah (Query) di bawah ini untuk membuat tabel sederhana bernama books. Tabel ini akan menyimpan ID, judul buku, penulis, dan tahun terbit.

SQL

CREATE TABLE books (
    id SERIAL PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    author VARCHAR(255) NOT NULL,
    published_year INT
);

 Untuk percobaan, tambahkan setidaknya satu baris data (dummy data) menggunakan perintah berikut:

SQL

INSERT INTO books (title, author, published_year) VALUES ('Belajar Node.js', 'John Doe', 2023);

Langkah 3: Konfigurasi Koneksi Database (Environment Variables)

Dalam tutorial rest api express ini, kita akan menerapkan best practice keamanan sejak awal. Jangan pernah menuliskan password atau username database secara eksplisit (langsung) di dalam kode JavaScript Anda.

Buat sebuah file baru bernama .env di direktori utama (root) proyek Anda dan tambahkan pengaturan berikut (pastikan untuk menyesuaikan DB_PASSWORD dengan kata sandi PostgreSQL milik Anda sendiri):

Cuplikan kode

DB_USER=postgres
DB_HOST=localhost
DB_DATABASE=bookstore
DB_PASSWORD=password_rahasia_anda
DB_PORT=5432
PORT=3000

 Setelah itu, buat file bernama db.js. File ini berfungsi untuk mengonfigurasi fitur Connection Pool. Konsep pool jauh lebih disarankan karena dapat menggunakan ulang (recycle) koneksi database, sehingga performa API akan jauh lebih cepat jika menangani banyak request sekaligus.

JavaScript

const { Pool } = require('pg');
require('dotenv').config();

const pool = new Pool({
    user: process.env.DB_USER,
    host: process.env.DB_HOST,
    database: process.env.DB_DATABASE,
    password: process.env.DB_PASSWORD,
    port: process.env.DB_PORT,
});

module.exports = pool;

 Langkah 4: Membuat Server Express dan Operasi CRUD

Kini saatnya kita masuk ke bagian inti. Buatlah file bernama index.js. Di sinilah keseluruhan logika routing API Anda (Create, Read, Update, Delete) akan didefinisikan.

const express = require('express');

const pool = require('./db');

require('dotenv').config();

const app = express();

const port = process.env.PORT || 3000;

// Middleware esensial agar Express dapat mem-parsing data JSON

app.use(express.json());

// 1. GET: Mengambil semua data buku

app.get('/api/books', async (req, res) => {

    try {

        const result = await pool.query('SELECT * FROM books ORDER BY id ASC');

        res.status(200).json(result.rows);

    } catch (err) {

        console.error(err.message);

        res.status(500).json({ error: 'Terjadi kesalahan pada server' });

    }

});

// 2. GET: Mengambil data satu buku berdasarkan ID

app.get('/api/books/:id', async (req, res) => {

    try {

        const { id } = req.params;

        const result = await pool.query('SELECT * FROM books WHERE id = $1', [id]);

        

        if (result.rows.length === 0) {

            return res.status(404).json({ message: 'Buku tidak ditemukan' });

        }

        res.status(200).json(result.rows[0]);

    } catch (err) {

        console.error(err.message);

        res.status(500).json({ error: 'Terjadi kesalahan pada server' });

    }

});

// 3. POST: Menambahkan buku baru

app.post('/api/books', async (req, res) => {

    try {

        const { title, author, published_year } = req.body;

        // Menggunakan Parameterized Query ($1, $2) untuk mencegah SQL Injection

        const newBook = await pool.query(

            'INSERT INTO books (title, author, published_year) VALUES ($1, $2, $3) RETURNING *',

            [title, author, published_year]

        );

        res.status(201).json(newBook.rows[0]);

    } catch (err) {

        console.error(err.message);

        res.status(500).json({ error: 'Terjadi kesalahan pada server' });

    }

});

// 4. PUT: Mengubah (Update) data buku berdasarkan ID

app.put('/api/books/:id', async (req, res) => {

    try {

        const { id } = req.params;

        const { title, author, published_year } = req.body;

        

        const updateBook = await pool.query(

            'UPDATE books SET title = $1, author = $2, published_year = $3 WHERE id = $4 RETURNING *',

            [title, author, published_year, id]

        );

        

        if (updateBook.rows.length === 0) {

            return res.status(404).json({ message: 'Buku tidak ditemukan' });

        }

        res.status(200).json({ message: 'Data buku berhasil diperbarui!', book: updateBook.rows[0] });

    } catch (err) {

        console.error(err.message);

        res.status(500).json({ error: 'Terjadi kesalahan pada server' });

    }

});

// 5. DELETE: Menghapus data buku dari database

app.delete('/api/books/:id', async (req, res) => {

    try {

        const { id } = req.params;

        const deleteBook = await pool.query('DELETE FROM books WHERE id = $1 RETURNING *', [id]);

        

        if (deleteBook.rows.length === 0) {

            return res.status(404).json({ message: 'Buku tidak ditemukan' });

        }

        res.status(200).json({ message: 'Buku berhasil dihapus dari sistem' });

    } catch (err) {

        console.error(err.message);

        res.status(500).json({ error: 'Terjadi kesalahan pada server' });

    }

});

// Menjalankan Server

app.listen(port, () => {

    console.log(`Server API berhasil berjalan di port http://localhost:${port}`);

});

Catatan penting: Perhatikan penggunaan $1, $2, $3 pada kueri PostgreSQL di atas. Pendekatan ini dinamakan Parameterized Query, sebuah teknik fundamental dalam keamanan database untuk melindungi aplikasi Anda dari celah kerentanan SQL Injection.

Langkah 5: Menguji REST API

Kini saatnya melakukan evaluasi untuk membuktikan cara membuat rest api node js ini berjalan sempurna. Buka terminal Anda dan jalankan perintah:

Bash

node index.js

 Jika muncul pesan "Server API berhasil berjalan", silakan buka aplikasi Postman. Uji kelima endpoint yang telah kita buat:

• GET /api/books: Anda akan melihat data dummy yang telah kita buat sebelumnya.

• POST /api/books: Pilih bagian Body, klik raw, ubah teks menjadi JSON, lalu kirimkan payload seperti: {"title": "Belajar Express", "author": "Jane Doe", "published_year": 2024}.

• Lakukan hal serupa untuk menguji ID buku spesifik menggunakan metode PUT dan DELETE.

Tips Lanjutan: Mencapai Skalabilitas Produksi (Production Scale)

Membuat API yang bisa berfungsi adalah satu hal, tetapi merancang sistem backend yang siap menghadapi lonjakan traffic (skalabel) membutuhkan perencanaan tambahan. Jika Anda ingin melanjutkan dari sekadar tutorial ini menuju tahap production, pertimbangkan hal berikut:

1. Gunakan Arsitektur MVC (Model-View-Controller): Menyimpan semua jalur rute API dalam satu file index.js tidak akan efisien seiring bertambahnya ukuran aplikasi. Pisahkan Routes (jalur API), Controllers (logika bisnis), dan struktur konfigurasi agar kode lebih mudah dikelola.

2. Validasi Request: Jangan percaya data dari pengguna secara buta. Gunakan pustaka tambahan seperti Joi atau express-validator untuk memastikan request body sesuai dengan tipe data yang diharapkan database.

3. Kemanan Tambahan (Security): Implementasikan middleware seperti helmet untuk memperkuat lapisan headers HTTP dan cors untuk membatasi domain mana saja yang berhak mengonsumsi data dari API Anda.

Kesimpulan

Selamat! Anda baru saja mempraktikkan tutorial rest api express yang bersih, berorientasi kinerja tinggi, dan terhubung langsung dengan sistem database relasional kuat seperti PostgreSQL.

Dengan menguasai dasar-dasar ini, Anda memiliki fondasi kokoh untuk melangkah ke tahap selanjutnya, misalnya seperti menambahkan sistem otentikasi JWT (JSON Web Tokens), membuat relasi tabel yang rumit, maupun men-deploy server ini ke layanan cloud. Tetap konsisten berlatih dan kembangkan kodingan ini menjadi portofolio sistem backend nyata. Node.js dan PostgreSQL adalah investasi pengetahuan yang sangat tinggi value-nya di industri IT saat ini. Selamat mencoba!