Definisi Arsitektur REST
Representational State Transfer (REST) adalah gaya arsitektur perangkat lunak untuk sistem terdistribusi yang menggunakan protokol HTTP sebagai media komunikasi. REST bukan sebuah protokol atau standar ketat, melainkan sekumpulan prinsip desain yang memungkinkan API menjadi skalabel, ringan, dan mudah dipelihara. Fokus utamanya adalah pada sumber daya (resources) yang diidentifikasi melalui URI (Uniform Resource Identifier).
6 Constraint Utama REST
Sebuah API dianggap RESTful jika memenuhi enam batasan arsitektural berikut:
| Constraint | Deskripsi |
|---|---|
| Client-Server | Pemisahan tanggung jawab antara antarmuka pengguna (client) dan penyimpanan data (server). |
| Stateless | Setiap request dari client harus berisi semua informasi yang diperlukan server untuk memprosesnya. |
| Cacheable | Respon server harus mendefinisikan dirinya sebagai cacheable atau tidak untuk meningkatkan efisiensi. |
| Uniform Interface | Penggunaan antarmuka seragam (URI, metode HTTP, representasi data) untuk interaksi antar komponen. |
| Layered System | Client tidak perlu tahu apakah ia terhubung langsung ke server atau melalui perantara (load balancer/proxy). |
| Code on Demand | Opsional; server dapat memperluas fungsi client dengan mengirimkan kode yang dapat dieksekusi (misalnya JavaScript). |
Metode HTTP dalam REST API
REST API memanfaatkan metode HTTP standar untuk melakukan operasi CRUD (Create, Read, Update, Delete):
- GET: Mengambil representasi sumber daya tanpa mengubah status server.
- POST: Membuat sumber daya baru di server.
- PUT: Memperbarui sumber daya yang ada secara keseluruhan (replace).
- PATCH: Memperbarui sebagian dari sumber daya (partial update).
- DELETE: Menghapus sumber daya yang ditentukan.
Struktur URI dan Status Code
Desain URI yang baik harus menggunakan kata benda (noun) dan jamak (plural). Contoh: /api/v1/users bukan /api/getUsers. Selain itu, penggunaan HTTP Status Code harus tepat:
- 200 OK: Permintaan berhasil.
- 201 Created: Sumber daya berhasil dibuat.
- 400 Bad Request: Kesalahan sintaks pada request client.
- 401 Unauthorized: Memerlukan autentikasi.
- 404 Not Found: Sumber daya tidak ditemukan.
- 500 Internal Server Error: Kesalahan pada sisi server.
Tips Implementasi
Gunakan format data JSON sebagai standar pertukaran data karena ringan dan didukung oleh hampir semua bahasa pemrograman. Pastikan API memiliki dokumentasi yang jelas menggunakan standar seperti OpenAPI (Swagger) agar mudah dikonsumsi oleh pengembang lain.