GraphQL vs REST API: Mana Arsitektur yang Lebih Superior?

Keterbatasan REST API (Menu Makanan yang Kaku)

Arsitektur REST API ibarat memesan makanan Paket Hemat di restoran cepat saji. Jika kamu menembak *endpoint* GET /api/users/1, server akan mengembalikan SEMUA data pengguna itu (Nama, Umur, Alamat, Nomor HP, Password Hash, Riwayat Transaksi). Formasi data ini dikunci mati oleh *Backend Developer*.

Jika halaman *Frontend* HP-mu HANYA butuh menampilkan nama dan foto profilnya saja, kamu tetap dipaksa men-download *payload* JSON raksasa tadi. Ini membuang-buang kuota data pengguna dan memperlambat loading. Masalah ini disebut Over-fetching (Menarik Data Berlebihan).

Munculnya GraphQL (Menu Prasmanan)

Untuk mengatasi kebuntuan tersebut, insinyur Facebook merilis GraphQL. Filosofi GraphQL adalah: Biarkan Frontend yang Memilih Datanya Sendiri!

Di arsitektur ini, kamu HANYA PUNYA 1 ENDPOINT saja (biasanya POST /graphql). Frontend (React/Mobile) akan mengirimkan sebuah "Surat Pesanan" (Query) ke dalam *Body* API-nya.

Contoh Surat Pesanan (Query) Frontend:

query {
  user(id: 1) {
    nama
    fotoProfil
  }
}

Server GraphQL membaca surat ini, masuk ke Database, dan HANYA mengembalikan field nama dan fotoProfil. Tidak ada lagi satu bit pun data sampah (Over-fetching) yang terbuang sia-sia!

Menyelesaikan Masalah Under-fetching

Di REST, jika kamu butuh data Profil User, Daftar Temannya, dan Postingan Terakhirnya, kamu harus memanggil (Fetch) 3 URL API secara terpisah. Ini disebut Under-fetching.
Dengan GraphQL, kamu bisa menggabungkan permintaan lintas-tabel (Relasi) itu hanya dalam DUA KALI tembakan API tunggal. GraphQL akan merajut relasi tabelnya di server secara ajaib.

Lalu, Kenapa Semua Orang Tidak Pindah ke GraphQL?

Sayangnya, GraphQL adalah mimpi buruk bagi keamaan dan performa Backend jika tidak di-setting dengan benar.

• Caching Sangat Sulit: Karena Endpoint-nya hanya satu (/graphql) dan selalu menggunakan POST, Browser dan CDN Cloudflare tidak bisa men-cache hasilnya secara otomatis layaknya HTTP GET di REST API.
• Query Kiamat: Jika Hacker (atau Frontend amatir) tidak sengaja menulis Query berlapis tanpa batas ("Berikan data teman Budi, lalu teman dari temannya Budi, lalu temannya lagi..."), Server *Database*-mu akan hang dan meledak karena Infinite Looping Query.

Kesimpulan: Gunakan REST API untuk proyek 90% aplikasi standar. Pindahlah ke GraphQL HANYA jika *Frontend*-mu sangat dinamis dan memiliki banyak platform (Web, iOS, Android, SmartWatch) yang masing-masing membutuhkan bentuk data yang berbeda-beda dari satu *Database* pusat.