[![Netlify Status]()

Project ini adalah contoh implementasi REST API sederhana untuk manajemen data buku menggunakan Express.js dan MongoDB, serta dideploy ke Netlify Functions.

Fitur

• CRUD (Create, Read, Update, Delete) data buku
• Middleware validasi API Key
• Dokumentasi API dengan Swagger UI
• Struktur folder mengikuti format yang kompatibel dengan Netlify Functions

Dokumentasi API

API ini terdokumentasi menggunakan Swagger UI.

Lihat dokumentasi di:
👉 https://book-api-express-mongodb.netlify.app/api-docs/

Definisi API ditulis di file swagger.yaml.
Panduan membuatnya: https://swagger.io/docs/specification/v3_0/basic-structure/

Struktur Proyek

.
├── config
│   └── db.config.js           # Konfigurasi koneksi MongoDB
├── controllers
│   └── book.controller.js     # Logika utama CRUD buku
├── index.js                   # Entry point lokal (tidak digunakan Netlify)
├── middleware
│   └── validate.js            # Middleware validasi API key
├── models
│   └── book.js                # Schema mongoose untuk buku
├── netlify
│   └── functions
│       ├── api.js             # Entry point Netlify Functions
│       └── swagger.yaml       # Definisi dokumentasi Swagger
├── netlify.toml               # Konfigurasi deploy Netlify
├── package.json
├── package-lock.json
├── public
│   ├── favicon.ico            # Ikon browser (opsional)
│   └── index.html             # Halaman statis (opsional)
└── routes
    └── book.router.js         # Definisi rute Express

Penjelasan Teknis

• Netlify menjalankan aplikasi melalui file netlify/functions/api.js, bukan index.js.
• File index.js digunakan saat testing lokal. Untuk itu, baris app.listen() perlu diaktifkan secara manual (lihat bagian di bawah).
• Routing API didefinisikan di routes/book.router.js, lalu digunakan di api.js dengan middleware validasi API key:

app.use("/api/books", validateApiKey, router);

Dengan rute-rute berikut:

Method	Endpoint	Deskripsi
POST	/api/books	Menambahkan buku baru
GET	/api/books	Mengambil semua buku
GET	/api/books/:id	Mengambil satu buku
PUT	/api/books/:id	Memperbarui buku
DELETE	/api/books/:id	Menghapus satu buku
DELETE	/api/books	Menghapus semua buku

Testing Lokal

Untuk menjalankan secara lokal (tidak melalui Netlify):

1. Buka file index.js, lalu hapus komentar pada baris app.listen() seperti ini:

const PORT = process.env.PORT;
app.listen(PORT, () => {
  console.log(`Server is running on http://localhost:${PORT}/`);
});

2. Jalankan server dengan:

npm start

Jika kamu menggunakan Netlify CLI dan ingin mensimulasikan fungsi serverless secara lokal:

netlify dev

Deployment

Aplikasi ini dideploy ke Netlify dengan konfigurasi berikut di netlify.toml:

[build]
  publish = "public"
  functions = "netlify/functions"

[functions]
  external_node_modules = ["express"]
  node_bundler = "esbuild"
  included_files = ["netlify/functions/swagger.yaml"]

[[redirects]]
  from = "/api-docs/*"
  to = "/.netlify/functions/api/api-docs/:splat"
  status = 200

[[redirects]]
  from = "/api-docs"
  to = "/.netlify/functions/api/api-docs"
  status = 200


# Redirect khusus untuk API routes
[[redirects]]
  from = "/api/*"
  to = "/.netlify/functions/api/:splat"
  status = 200
  force = true

Validasi API Key

Setiap request ke endpoint /api/books harus menyertakan header berikut:

x-api-key: YOUR_API_KEY

Jika tidak menyertakan API key atau menggunakan key yang salah, maka request akan ditolak dengan status 401 atau 403.