Daftar Isi Utama

• Lihat indeks lengkap di [01. Pengenalan]

Panduan ini untuk siapa

• Pembelajar frontend yang ingin punya fondasi full-stack yang praktis
• Pemula yang lagi bikin API backend pertama dengan TypeScript
• Siapa pun yang ingin kolaborasi frontend-backend jadi lebih lancar

Apa yang akan Anda pelajari

• Dasar server Node.js dengan mindset API-first
• Dasar desain REST API yang rapi dan mudah dirawat
• Pola validasi request dan error response yang konsisten

Mengapa topik ini penting

Kalau paham dasar backend, Anda tidak lagi melihat API sebagai kotak hitam.

Ini membantu Anda bikin integrasi frontend lebih rapi, debugging lebih cepat, dan komunikasi teknis dengan backend jauh lebih efektif.

Konsep inti

Dasar HTTP

• Method: GET, POST, PUT/PATCH, DELETE
• Konsistensi status code dan bentuk respons

Anggap HTTP sebagai bahasa kontrak antara client dan server.

Arsitektur API

• Routes, controllers, services (pemisahan dasar)
• Validasi data sebelum diproses

Pemisahan sederhana ini bikin codebase tetap kebaca saat endpoint bertambah.

Panduan langkah demi langkah

Langkah 1 — Buat project API

Inisialisasi project Node + TypeScript dengan struktur folder yang jelas.

Langkah 2 — Tambahkan route CRUD

Implement endpoint CRUD dengan bentuk respons yang konsisten.

Langkah 3 — Tambahkan middleware validasi/error

Tambahkan validasi dan middleware error terpusat agar output API tetap prediktif.

Target bab ini: perilaku API jelas, baik untuk tim frontend maupun backend.

Contoh praktis

Contoh 1 — Route GET

app.get("/tasks", (_req, res) => {
	res.json([{ id: 1, title: "Learn Node.js" }]);
});

Tip:

• Jaga route handler tetap pendek; logic berat pindahkan ke service.

Contoh 2 — Konsep validasi

• Pastikan title tidak kosong
• Kembalikan 400 dengan pesan yang mudah dipahami

Tambahan penting:

• Samakan bentuk error response (misal: message, code, dan details opsional).

Kesalahan umum dan cara menghindarinya

• Struktur JSON respons berubah-ubah -> tentukan satu standar respons
• Validasi input dilewati -> data invalid masuk ke penyimpanan
• Business logic ditaruh langsung di route -> jaga handler tetap tipis, pindahkan ke service
• Detail error internal dibuka ke client -> mapping ke pesan yang aman dan jelas

Mini Project

• Buat Task API dengan:
• endpoint CRUD lengkap,
• validasi body request,
• format respons sukses/error yang konsisten,
• penyimpanan in-memory untuk versi awal.

Bonus:

• Tambahkan query pagination di endpoint daftar task.

Latihan cepat

• Tambahkan satu route GET dan satu route POST
• Kembalikan 400 untuk body yang invalid
• Tambahkan satu penyimpanan in-memory sederhana
• Buat satu helper reusable untuk respons sukses API

Ringkasan utama

• Dasar backend membuat frontend developer jauh lebih efektif di tim produk
• Kontrak API yang konsisten menurunkan bug integrasi secara signifikan
• Validasi dan standar error yang jelas adalah fondasi API yang andal

Langkah berikutnya

Lanjut ke [18. Deployment dan Production Basics].