RESTful API , singkatan dari Application Programming Interface, adalah salah satu metode komunikasi data terkemuka dalam dunia pengembangan aplikasi. API ini mengizinkan aplikasi klien dan server berkomunikasi satu sama lain dengan protokol HTTP. Dalam artikel ini, kita akan memelajari cara membuat api restfull dengan menngunakan node.js yang merupakan platform javascript yang terkenal baik dengan kecepatan eksekusi dan juga dalam kasus aplikasi server.
Apa yang dimaksud dengan RESTful API?
API RESTful mengikuti prinsip-prinsip REST, yaitu:
- Tanpa kewarganegaraan: Setiap klien harus menyertakan semua informasi yang diperlukan untuk memproses permintaan di server.
- Arsitektur Berorientasi Sumber Daya: Sumber daya seperti pengguna atau produk diperlakukan seperti URL.
- CRUD: Mendukung operasi CRUD (buat, baca, perbarui, hapus).
- Format Data Standar: JSON adalah format pertukaran data yang digunakan di sebagian besar aplikasi antara klien dan server.
 |
| sumber: stackademic.com |
Menyiapkan Node.js dan Express
Hal pertama yang harus dilakukan, pastikan Anda telah menginstal Node.js. Untuk memulai proyek Anda, lakukan langkah-langkah berikut:
1. Inisialisasi Proyek: Buat direktori proyek baru dan inisialisasi menggunakan npm:
mkdir rest-api-node
cd rest-api-node
npm init -y
2. Instal Express: Instal Express untuk membangun API:
npm install express
Membuat API
1. Menyiapkan Server Dasar:
Buat berkas bernama index.js dan tulis kode berikut ini untuk menyiapkan server sederhana:
const express = require('express');
const app = express();
const port = 3000;
// Middleware to parse JSON
app.use(express.json());
// Basic endpoint
app.get('/', (req, res) => {
res.send('Welcome to the RESTful API built with Node.js!');
});
app.listen(port, () => {
console.log(`Server is running at http://localhost:${port}`);
});
node index.js
2. Menambahkan Operasi CRUD:
app.post('/users', (req, res) => {
const newUser = req.body;
// Simulate saving the user to a database
res.status(201).json({ message: 'User created successfully', user: newUser });
});
app.get('/users', (req, res) => {
const users = [{ id: 1, name: 'Jane Doe' }]; // Example data
res.json(users);
});
app.put('/users/:id', (req, res) => {
const { id } = req.params;
const updatedUser = req.body;
res.json({ message: `User with ID ${id} updated`, user: updatedUser });
});
app.delete('/users/:id', (req, res) => {const { id } = req.params;res.json({ message: `User with ID ${id} deleted` });});
Middleware dan Penanganan Kesalahan
Middleware adalah tempat Anda dapat melakukan prapemrosesan permintaan di Express. Anda dapat memvalidasi data, misalnya, sebelum memprosesnya:
// Middleware for validation
app.post('/users', (req, res, next) => {
const { name } = req.body;
if (!name) {
return res.status(400).json({ message: 'Name is required' });
}
next();
});
Untuk menangkap kesalahan, Anda dapat menggunakan middleware seperti itu:
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).json({ message: 'An internal server error occurred' });
});
Menghubungkan ke Database
Meskipun contoh kita bekerja pada data dalam memori, Anda dapat dengan mudah mengonfigurasikannya untuk terhubung ke database, seperti MongoDB atau PostgreSQL, untuk persistensi. Untuk MongoDB, Anda akan menginstal Mongoose:
npm install mongoose
Menyiapkan koneksi:
const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/users', { useNewUrlParser: true, useUnifiedTopology: true })
.then(() => console.log('Connected to MongoDB'))
.catch(err => console.error('Error connecting to MongoDB:', err));
Kesimpulan
kembali ke>>>> Pengantar Node.js: Membangun Aplikasi yang Dapat Diskalakan