Dalam pengembangan aplikasi web modern, komunikasi antara frontend dan backend merupakan salah satu bagian penting yang perlu dipahami. Ketika pengguna membuka halaman produk, melakukan login, mengirim formulir, atau melihat laporan, biasanya terdapat proses pertukaran data antara browser dan server.
Salah satu teknologi yang banyak digunakan untuk menghubungkan berbagai bagian aplikasi tersebut adalah API (Application Programming Interface). API memungkinkan suatu aplikasi berkomunikasi dengan sistem lain tanpa harus mengetahui seluruh proses internal yang terjadi di dalamnya.
Salah satu pendekatan API yang populer dalam pengembangan web adalah REST API (Representational State Transfer API). Teknologi ini banyak digunakan untuk membangun aplikasi web, aplikasi mobile, sistem informasi, hingga layanan yang terintegrasi dengan platform lain.
Lalu, apa itu REST API? Apa fungsi, cara kerja, dan contoh penerapannya dalam pengembangan aplikasi web? Simak pembahasan berikut ini.
1. Apa Itu API?
API merupakan singkatan dari Application Programming Interface, yaitu antarmuka yang memungkinkan dua atau lebih perangkat lunak berkomunikasi dan bertukar informasi. Secara sederhana, API berperan sebagai penghubung antara aplikasi yang membutuhkan data atau layanan dengan sistem yang menyediakan data atau layanan tersebut.
Sebagai contoh, sebuah aplikasi cuaca membutuhkan informasi suhu dan kondisi cuaca dari layanan penyedia data. Aplikasi tersebut dapat mengirimkan permintaan melalui API, kemudian menerima informasi cuaca dalam format yang dapat diproses dan ditampilkan.
Dalam pengembangan aplikasi web, API sering digunakan untuk menghubungkan frontend dengan backend. Misalnya, ketika pengguna membuka halaman daftar mahasiswa, frontend mengirimkan permintaan ke API. Backend memproses permintaan tersebut, mengambil data mahasiswa dari database, kemudian mengirimkan hasilnya kembali ke frontend. Dengan demikian, frontend tidak harus berkomunikasi langsung dengan database. Proses pengolahan dan pengelolaan data dapat dilakukan melalui backend.
2. Apa Itu REST API?
REST API adalah API yang menerapkan prinsip arsitektur REST (Representational State Transfer) untuk memungkinkan komunikasi antara sistem melalui jaringan. REST diperkenalkan oleh Roy Fielding dalam disertasinya pada tahun 2000. Pendekatan ini menggunakan konsep sumber daya atau resource yang dapat diakses dan dimanipulasi melalui representasi tertentu. Dalam implementasi web, REST API umumnya menggunakan protokol HTTP untuk mengirimkan permintaan dan menerima respons. Setiap data atau layanan biasanya direpresentasikan sebagai resource yang memiliki alamat atau endpoint tertentu.
Sebagai contoh, sebuah aplikasi sistem informasi mahasiswa dapat menyediakan beberapa endpoint:
/api/mahasiswauntuk mengakses data mahasiswa./api/dosenuntuk mengakses data dosen./api/mata-kuliahuntuk mengakses data mata kuliah./api/nilaiuntuk mengakses data nilai.
Frontend dapat mengirimkan permintaan ke endpoint tersebut menggunakan HTTP Method seperti GET, POST, PUT, PATCH, dan DELETE. Respons dari REST API sering menggunakan format JSON (JavaScript Object Notation) karena mudah dibaca dan dapat diproses oleh berbagai bahasa pemrograman.
Perlu diketahui bahwa tidak semua API berbasis HTTP otomatis disebut REST API. REST memiliki sejumlah prinsip arsitektur yang perlu diperhatikan dalam perancangannya.
Baca juga Cara Membuat REST API dengan Laravel 13 untuk Pemula
3. Fungsi REST API dalam Pengembangan Web
REST API memiliki peran penting dalam membangun aplikasi yang terdiri dari beberapa komponen atau layanan yang saling berkomunikasi. Berikut beberapa fungsi REST API dalam pengembangan aplikasi.
A. Menghubungkan Frontend dan Backend
REST API memungkinkan frontend mengirimkan permintaan kepada backend untuk mengambil atau mengolah data. Sebagai contoh, halaman dashboard membutuhkan informasi jumlah pengguna dan transaksi. Frontend dapat meminta data tersebut melalui endpoint API, kemudian menampilkan hasilnya dalam bentuk kartu informasi atau grafik.
B. Menghubungkan Aplikasi Web dan Mobile
REST API memungkinkan satu backend digunakan oleh beberapa jenis aplikasi. Misalnya, sebuah sistem informasi memiliki aplikasi web untuk administrator dan aplikasi Android untuk pengguna. Keduanya dapat mengakses layanan backend yang sama melalui API. Dengan pendekatan ini, pengembang tidak harus membuat seluruh proses pengolahan data secara terpisah untuk setiap platform.
C. Memudahkan Integrasi Antar Sistem
REST API dapat digunakan untuk menghubungkan aplikasi dengan layanan eksternal.
Contohnya:
- Integrasi dengan layanan pembayaran.
- Mengambil data dari layanan pihak ketiga.
- Mengirim notifikasi melalui layanan tertentu.
- Menghubungkan sistem informasi dengan aplikasi lain.
Integrasi tersebut tetap bergantung pada API, autentikasi, dan ketentuan akses dari masing-masing layanan.
D. Memisahkan Frontend dan Backend
REST API membantu memisahkan tanggung jawab antara tampilan aplikasi dan proses pengolahan data. Frontend dapat dikembangkan menggunakan React, Vue, atau JavaScript biasa, sedangkan backend dapat menggunakan PHP, Laravel, Python, Node.js, maupun teknologi lainnya. Keduanya dapat berkomunikasi melalui kontrak API yang telah disepakati.
Baca juga Apa itu Frontend dan Backend
E. Mendukung Pengembangan Aplikasi yang Lebih Fleksibel
Dengan API yang dirancang secara konsisten, pengembang dapat mengembangkan fitur baru atau menghubungkan platform tambahan tanpa harus mengubah seluruh sistem.
Misalnya, ketika sebuah aplikasi web sudah memiliki REST API untuk mengelola data produk, layanan yang sama dapat digunakan oleh aplikasi mobile selama kebutuhan akses dan format datanya sesuai.
4. Bagaimana Cara Kerja REST API?
REST API bekerja dengan mekanisme komunikasi antara client dan server melalui jaringan. Client merupakan pihak yang mengirimkan permintaan, sedangkan server merupakan pihak yang menerima dan memproses permintaan tersebut.
Dalam aplikasi web, client dapat berupa browser, aplikasi frontend, aplikasi mobile, atau sistem lain yang membutuhkan data. Secara umum, proses kerja REST API adalah sebagai berikut:
- Pengguna melakukan tindakan pada aplikasi, misalnya membuka halaman daftar produk.
- Frontend mengirimkan HTTP Request ke endpoint REST API.
- Server menerima dan memeriksa permintaan tersebut.
- Backend menjalankan proses sesuai kebutuhan.
- Jika diperlukan, backend mengambil atau menyimpan data ke database.
- Server mengirimkan HTTP Response kepada client.
- Frontend membaca respons dan menampilkan hasilnya kepada pengguna.
Sebagai contoh, ketika pengguna membuka daftar produk, frontend mengirimkan permintaan:
GET /api/produk HTTP/1.1
Host: example.com
Accept: application/json
Server kemudian memproses permintaan dan mengirimkan respons berupa data produk.
{
"status": true,
"message": "Data produk berhasil diambil",
"data": [
{
"id": 1,
"nama": "Laptop",
"harga": 7500000
},
{
"id": 2,
"nama": "Smartphone",
"harga": 3500000
}
]
}
Frontend kemudian membaca data JSON tersebut dan menampilkannya dalam bentuk daftar produk pada halaman website.
5. Mengenal HTTP Method dalam REST API
HTTP Method digunakan untuk menunjukkan jenis tindakan yang ingin dilakukan client terhadap suatu resource. Dalam REST API, terdapat beberapa HTTP Method yang sering digunakan.
| HTTP Method | Fungsi | Contoh Penggunaan |
|---|---|---|
| GET | Mengambil data | Menampilkan daftar mahasiswa |
| POST | Membuat atau mengirim data | Menambahkan mahasiswa baru |
| PUT | Mengganti representasi data secara keseluruhan | Memperbarui seluruh data mahasiswa |
| PATCH | Memperbarui sebagian data | Mengubah alamat mahasiswa |
| DELETE | Menghapus data | Menghapus data mahasiswa |
Untuk memahami penggunaannya, berikut contoh endpoint pada aplikasi data mahasiswa.
A. GET
GET digunakan untuk mengambil data dari server. Contoh:
GET /api/mahasiswa
Permintaan tersebut digunakan untuk mendapatkan daftar mahasiswa.
Jika ingin mengambil data mahasiswa berdasarkan ID, endpoint dapat menggunakan:
GET /api/mahasiswa/1
B. POST
POST digunakan untuk mengirim data baru ke server. Contoh:
POST /api/mahasiswa
Content-Type: application/json
Data yang dikirim:
{
"nama": "Andi",
"nim": "2026001",
"jurusan": "Informatika"
}
Backend kemudian memvalidasi data dan menyimpannya ke database jika memenuhi ketentuan aplikasi.
C. PUT
PUT digunakan untuk mengganti representasi data pada resource tertentu. Contoh:
PUT /api/mahasiswa/1
Content-Type: application/json
Data yang dikirim:
{
"nama": "Andi Pratama",
"nim": "2026001",
"jurusan": "Sistem Informasi"
}
Pada desain API yang mengikuti semantik HTTP, PUT umumnya digunakan untuk memperbarui representasi resource secara keseluruhan.
D. PATCH
PATCH digunakan untuk memperbarui sebagian informasi pada resource. Contoh:
PATCH /api/mahasiswa/1
Content-Type: application/json
Data yang dikirim:
{
"jurusan": "Teknik Informatika"
}
Pada contoh tersebut, hanya informasi jurusan yang diperbarui.
E. DELETE
DELETE digunakan untuk menghapus resource tertentu. Contoh:
DELETE /api/mahasiswa/1
Permintaan tersebut ditujukan untuk menghapus data mahasiswa dengan ID 1, sesuai aturan penghapusan yang diterapkan oleh aplikasi.
6. Mengenal Endpoint, Request, dan Response
Dalam penggunaan REST API, terdapat beberapa istilah yang perlu dipahami agar lebih mudah membaca dokumentasi maupun mengembangkan API.
A. Endpoint
Endpoint adalah alamat atau URL yang digunakan untuk mengakses resource atau layanan API. Contoh:
https://example.com/api/mahasiswa
Endpoint tersebut dapat digunakan untuk mengakses resource mahasiswa. Tindakan yang dilakukan bergantung pada HTTP Method dan aturan yang diterapkan server.
B. Request
Request merupakan permintaan yang dikirimkan client kepada server. Sebuah HTTP Request dapat terdiri dari beberapa bagian, seperti:
- Method, misalnya GET atau POST.
- URL atau endpoint.
- Header untuk menyampaikan informasi tambahan.
- Body untuk mengirimkan data jika diperlukan.
Contoh request:
POST /api/mahasiswa HTTP/1.1
Host: example.com
Content-Type: application/json
{
"nama": "Siti",
"nim": "2026002"
}
C. Response
Response merupakan jawaban yang dikirimkan server setelah menerima dan memproses request. HTTP Response umumnya berisi:
- Status code.
- Header respons.
- Body yang dapat berisi data atau informasi hasil proses.
Contoh response:
HTTP/1.1 201 Created
Content-Type: application/json
{
"status": true,
"message": "Data mahasiswa berhasil ditambahkan"
}
Dengan memahami endpoint, request, dan response, pengembang dapat lebih mudah merancang serta menguji komunikasi antara client dan server.
7. Apa Itu JSON dalam REST API?
JSON merupakan singkatan dari JavaScript Object Notation, yaitu format pertukaran data yang menggunakan struktur sederhana berupa pasangan key dan value. JSON banyak digunakan dalam REST API karena dapat dibaca oleh manusia dan mudah diproses oleh berbagai bahasa pemrograman.
Contoh JSON:
{
"id": 1,
"nama": "Budi",
"email": "budi@example.com",
"aktif": true
}
Penjelasan:
idmerupakan identitas data.namamenyimpan nama pengguna.emailmenyimpan alamat email.aktifmenunjukkan status pengguna.
JSON mendukung beberapa tipe nilai, seperti string, number, boolean, object, array, dan null.
Contoh JSON dengan array:
{
"status": true,
"data": [
{
"id": 1,
"nama": "Budi"
},
{
"id": 2,
"nama": "Siti"
}
]
}
Frontend dapat membaca struktur tersebut dan menampilkan informasi pengguna sesuai kebutuhan aplikasi.
Selain JSON, API juga dapat menggunakan format pertukaran data lain. Namun, JSON merupakan salah satu format yang paling umum ditemui dalam pengembangan REST API.
8. Mengenal HTTP Status Code dalam REST API
HTTP Status Code merupakan kode yang digunakan server untuk menunjukkan hasil pemrosesan sebuah HTTP Request. Status code membantu client mengetahui apakah permintaan berhasil, perlu tindakan tambahan, atau mengalami kesalahan. Berikut beberapa status code yang sering digunakan.
| Status Code | Keterangan | Penggunaan |
|---|---|---|
| 200 OK | Permintaan berhasil | Data berhasil diambil |
| 201 Created | Resource berhasil dibuat | Data baru berhasil ditambahkan |
| 204 No Content | Permintaan berhasil tanpa body respons | Penghapusan berhasil |
| 400 Bad Request | Permintaan tidak valid | Format request salah |
| 401 Unauthorized | Autentikasi belum valid atau tidak tersedia | Token tidak valid |
| 403 Forbidden | Akses ditolak | Pengguna tidak memiliki izin |
| 404 Not Found | Resource tidak ditemukan | Data dengan ID tertentu tidak tersedia |
| 422 Unprocessable Content | Isi permintaan tidak dapat diproses | Validasi data gagal |
| 500 Internal Server Error | Terjadi kesalahan pada server | Proses backend mengalami error |
Status code tersebut dapat digunakan untuk membantu frontend menentukan tindakan berikutnya. Misalnya, jika server mengirimkan status 200, frontend dapat menampilkan data. Jika server mengirimkan status 401, aplikasi dapat meminta pengguna melakukan autentikasi kembali.
9. Contoh Penerapan REST API dalam Aplikasi Web
REST API dapat digunakan dalam berbagai jenis aplikasi. Berikut beberapa contoh penerapannya.
A. Sistem Informasi Akademik
Dalam sistem informasi akademik, REST API dapat digunakan untuk mengelola data mahasiswa, dosen, mata kuliah, jadwal, dan nilai.
Contoh endpoint:
GET /api/mahasiswa
GET /api/mahasiswa/1
POST /api/mahasiswa
PUT /api/mahasiswa/1
DELETE /api/mahasiswa/1
Frontend dapat menggunakan endpoint tersebut untuk menampilkan tabel mahasiswa, formulir tambah data, halaman edit, dan fitur penghapusan.
B. Aplikasi E-Commerce
Pada aplikasi e-commerce, REST API dapat digunakan untuk mengelola produk, kategori, keranjang belanja, pesanan, dan informasi pengguna.
Contoh endpoint:
GET /api/produk
GET /api/kategori
POST /api/keranjang
POST /api/pesanan
GET /api/pesanan/1
Ketika pengguna menambahkan produk ke keranjang, frontend mengirimkan permintaan ke backend. Backend kemudian memproses data tersebut sesuai aturan aplikasi.
C. Sistem Informasi Inventaris
Pada aplikasi inventaris, REST API dapat digunakan untuk mengelola data barang, stok, transaksi masuk, dan transaksi keluar.
Contoh endpoint:
GET /api/barang
POST /api/barang
PATCH /api/barang/1
GET /api/transaksi-masuk
GET /api/transaksi-keluar
D. Aplikasi Mobile
REST API juga dapat digunakan untuk menghubungkan aplikasi Android atau iOS dengan backend.
Sebagai contoh, aplikasi mobile untuk melihat jadwal perkuliahan dapat meminta data dari endpoint API yang sama dengan aplikasi web.
Dengan demikian, satu backend dapat melayani beberapa platform selama API dirancang sesuai kebutuhan masing-masing client.
10. Cara Menguji REST API Menggunakan Postman
Setelah REST API dibuat, pengembang perlu menguji apakah endpoint dapat menerima request dan memberikan response sesuai harapan. Salah satu aplikasi yang sering digunakan untuk pengujian API adalah Postman.
Postman memungkinkan pengembang mengirimkan HTTP Request, mengatur header, memasukkan body, serta melihat response dari server.
Berikut langkah sederhana untuk menguji REST API.
Langkah 1: Membuka Postman
Jalankan aplikasi Postman, kemudian buat request baru.
Langkah 2: Memasukkan Endpoint
Masukkan alamat API yang ingin diuji.
Contoh:
http://localhost:8000/api/mahasiswa
Alamat tersebut hanya contoh. Endpoint dapat berbeda sesuai konfigurasi aplikasi yang dibuat.
Langkah 3: Memilih HTTP Method
Pilih method GET untuk mengambil data mahasiswa.
Langkah 4: Mengirim Request
Klik tombol Send untuk mengirim permintaan ke server.
Langkah 5: Memeriksa Response
Perhatikan hasil respons yang ditampilkan Postman, seperti:
- HTTP Status Code.
- Response Body.
- Response Headers.
- Waktu respons.
Jika API berjalan dengan benar, server akan mengirimkan data sesuai endpoint yang diminta. Untuk menguji proses penambahan data, ubah method menjadi POST, pilih format body JSON, lalu masukkan data yang diperlukan. Pengujian juga perlu dilakukan untuk skenario kesalahan, seperti data tidak lengkap, token tidak valid, atau resource yang tidak ditemukan.
11. Prinsip REST API yang Perlu Diketahui
REST bukan sekadar penggunaan HTTP Method dan format JSON. REST memiliki sejumlah prinsip arsitektur yang menjadi dasar dalam perancangannya.
Berikut enam batasan arsitektur REST yang diperkenalkan oleh Roy Fielding.
A. Client-Server
Client dan server memiliki tanggung jawab yang terpisah. Client berfokus pada antarmuka dan interaksi pengguna, sedangkan server bertugas mengelola data serta proses aplikasi. Pemisahan ini memungkinkan keduanya dikembangkan secara lebih independen.
B. Stateless
Setiap request dari client harus membawa informasi yang diperlukan server untuk memproses permintaan tersebut. Server tidak menyimpan konteks sesi client sebagai bagian dari mekanisme komunikasi REST itu sendiri.
Sebagai contoh, jika API membutuhkan autentikasi, client perlu mengirimkan kredensial atau token yang sesuai pada setiap request yang memerlukan autentikasi.
C. Cacheable
Respons API dapat diberi informasi apakah boleh disimpan dalam cache atau tidak. Caching dapat membantu mengurangi permintaan berulang dan meningkatkan efisiensi komunikasi. Namun, data yang bersifat pribadi atau sensitif perlu memiliki aturan caching yang tepat.
D. Uniform Interface
REST menggunakan antarmuka komunikasi yang konsisten antara client dan server. Prinsip ini mencakup identifikasi resource, manipulasi resource melalui representasi, pesan yang menjelaskan dirinya sendiri, serta penggunaan hypermedia sebagai bagian dari interaksi aplikasi.
E. Layered System
Arsitektur REST memungkinkan adanya beberapa lapisan sistem di antara client dan server. Sebagai contoh, permintaan dapat melewati proxy, gateway, atau layanan keamanan sebelum mencapai server utama. Client tidak harus mengetahui seluruh struktur internal tersebut.
F. Code on Demand (Opsional)
Server dapat mengirimkan kode yang dapat dijalankan oleh client, misalnya JavaScript. Namun, prinsip ini bersifat opsional dan tidak harus diterapkan dalam setiap implementasi REST.
Keenam prinsip tersebut menjadi dasar untuk memahami mengapa REST memiliki karakteristik berbeda dari sekadar API HTTP biasa.
12. Kelebihan dan Kekurangan REST API
REST API memiliki sejumlah kelebihan yang membuatnya banyak digunakan dalam pengembangan aplikasi. Namun, pendekatan ini juga memiliki beberapa keterbatasan yang perlu dipertimbangkan.
Kelebihan REST API
- Mudah diintegrasikan. REST API dapat digunakan oleh berbagai aplikasi yang mendukung komunikasi HTTP.
- Mendukung banyak platform. Satu backend dapat melayani aplikasi web, mobile, dan client lainnya.
- Menggunakan format data yang fleksibel. JSON dapat diproses oleh berbagai bahasa pemrograman.
- Memisahkan frontend dan backend. Kedua bagian dapat dikembangkan secara lebih independen.
- Mendukung caching. Respons tertentu dapat disimpan untuk mengurangi permintaan berulang.
- Memiliki pola komunikasi yang umum. HTTP Method dan status code memudahkan pengembang memahami proses komunikasi.
Kekurangan REST API
- Perlu perancangan endpoint yang konsisten. Struktur API yang tidak terorganisasi dapat menyulitkan pengembangan.
- Jumlah request dapat meningkat. Halaman yang membutuhkan banyak data mungkin memerlukan beberapa permintaan API.
- Pengelolaan versi perlu diperhatikan. Perubahan struktur respons dapat memengaruhi client yang sudah menggunakan API.
- Keamanan harus dirancang dengan baik. Autentikasi, otorisasi, validasi, dan pembatasan akses tetap diperlukan.
- Tidak selalu cocok untuk setiap kebutuhan komunikasi. Aplikasi yang membutuhkan komunikasi real-time atau pola pengambilan data sangat kompleks mungkin memerlukan pendekatan lain.
13. Tips Keamanan dalam Pengembangan REST API
REST API sering digunakan untuk mengakses data dan menjalankan fungsi aplikasi. Karena itu, aspek keamanan harus diperhatikan sejak proses perancangan.
Berikut beberapa langkah yang dapat diterapkan.
- Gunakan HTTPS. Komunikasi antara client dan server perlu dilindungi dengan enkripsi TLS.
- Terapkan autentikasi. Pastikan identitas client atau pengguna diperiksa sebelum mengakses layanan yang dilindungi.
- Atur otorisasi. Jangan hanya memeriksa apakah pengguna sudah login. Pastikan pengguna memang memiliki izin untuk mengakses resource tertentu.
- Validasi setiap input. Periksa data yang dikirimkan client sebelum diproses atau disimpan.
- Lindungi kredensial. Jangan menyimpan password dalam bentuk teks biasa atau menampilkan token rahasia pada kode frontend.
- Terapkan rate limiting. Batasi jumlah permintaan untuk membantu mencegah penyalahgunaan layanan.
- Atur CORS dengan tepat. Batasi origin yang diizinkan mengakses API melalui browser sesuai kebutuhan aplikasi.
- Jangan menampilkan informasi sensitif. Respons API sebaiknya hanya mengirimkan data yang memang diperlukan client.
Keamanan REST API bukan hanya tanggung jawab satu komponen. Konfigurasi server, aplikasi backend, database, dan client perlu dirancang secara menyeluruh.
14. Kesimpulan
REST API merupakan pendekatan arsitektur yang banyak digunakan untuk membangun komunikasi antara aplikasi melalui jaringan. Dalam pengembangan web, REST API sering berfungsi sebagai penghubung antara frontend dan backend untuk mengambil, menambahkan, memperbarui, maupun menghapus data.
REST API umumnya menggunakan HTTP Method seperti GET, POST, PUT, PATCH, dan DELETE. Permintaan dikirimkan melalui endpoint tertentu, kemudian server memprosesnya dan mengembalikan respons yang dapat berisi data JSON serta HTTP Status Code.
Teknologi ini dapat diterapkan pada berbagai jenis aplikasi, mulai dari sistem informasi akademik, e-commerce, inventaris, hingga aplikasi mobile.
Dengan memahami konsep API, endpoint, request, response, HTTP Method, dan prinsip REST, pengembang memiliki dasar yang lebih kuat untuk membangun aplikasi web yang terintegrasi dan mudah dikembangkan.
Jika Anda sedang mempelajari pengembangan aplikasi web, memahami REST API merupakan langkah penting sebelum masuk ke praktik pembuatan layanan backend menggunakan PHP, Laravel, Node.js, Python, atau teknologi lainnya.
Anindyadev menyediakan layanan pengembangan website dan aplikasi berbasis web sesuai kebutuhan proyek. Anda juga dapat melihat berbagai pilihan source code program sebagai referensi untuk belajar dan mengembangkan aplikasi.