GraphQL vs REST: Semua yang Perlu Anda Ketahui

Mungkin sulit untuk memilih teknologi yang akan disertakan dalam tumpukan teknologi proyek Anda berikutnya. Dalam banyak kasus — dan terutama saat memilih antara GraphQL dan RESTful API — ini semua tentang memilih arsitektur desain API terbaik berikutnya.

Ada empat cara penting untuk membangun API: SOAP, GRPC, REST, dan GraphQL. Kami sering mempersempit pikiran kami ke REST dan GraphQL setiap kali kami ingin membangun API. Ini karena REST mengubah cara tradisional membangun API dengan SOAP dan GRPC.

GraphQL secara luas ditandai sebagai REST yang lebih baik karena mewakili cara yang lebih baik untuk membangun API. Banyak pengembang percaya bahwa GraphQL akan menggantikan REST. Banyak lagi yang telah menemukan bahwa GraphQL membantu memecahkan beberapa tantangan umum yang dihadapi pengembang saat membangun REST API.

Kedua metode membangun API ini sama sekali berbeda. Dalam praktiknya, teknologi ini bekerja dengan mengirimkan permintaan HTTP dan menerima hasilnya. Keduanya memiliki pro dan kontra, dan dalam artikel ini, kami akan membahas secara ekstensif dua teknologi hebat ini yang telah mengubah cara kami mengembangkan dan menskalakan API.

Namun, sebelum kita menyelami detailnya, pertama-tama mari kita jelajahi arti dari GraphQL dan RESTful APIs.

Apa itu GraphQL?

GraphQL adalah bahasa kueri API serta runtime untuk menjawab kueri tersebut dengan data yang ada. Itu juga dilengkapi dengan alat yang kuat untuk menangani bahkan pertanyaan yang paling kompleks.

Fitur utama GraphQL adalah kemampuannya untuk meminta dan menerima hanya data spesifik yang diminta — tidak lebih. Ini membuatnya lebih mudah untuk menskalakan API Anda bersama dengan aplikasi Anda.

Bagian paling menarik dari GraphQL adalah kemampuannya untuk memberi Anda semua data dalam satu titik akhir.

Diagram di atas adalah representasi khas arsitektur GraphQL. Klien membuat permintaan dari perangkat yang berbeda, dan GraphQL menangani permintaan mereka dan hanya mengembalikan data yang diminta. Ini dengan rapi memecahkan masalah pengambilan yang berlebihan dan pengambilan yang kurang di API RESTful.

Dalam contoh di atas, kami menunjukkan taman bermain GraphQL dan bagaimana Anda dapat meminta data dengan satu titik akhir. Di atas adalah titik akhir API, di sebelah kiri adalah kueri yang meminta nama benua, dan terakhir, di sebelah kanan, kami menanggapi kueri yang kami minta.

GraphQL dibuat oleh Facebook untuk tujuan utama memecahkan pengalaman pengembang aplikasi seluler mereka saat bekerja dengan REST API. Sejak versi open-source pertamanya dirilis pada tahun 2015, GraphQL telah mengalami pertumbuhan yang luar biasa karena adopsi teknologi oleh para pemain besar dalam bisnis teknologi.

Perusahaan yang Menggunakan GraphQL

Di bawah ini adalah daftar beberapa perusahaan dan aplikasi yang menggunakan GraphQL secara aktif di server mereka.

Facebook

Facebook membuat GraphQL, dan mereka telah menggunakannya dalam produksi untuk mendukung aplikasi seluler mereka sejak 2012. Perusahaan jejaring sosial multi-miliar dolar itu membuka sumber spesifikasi GraphQL pada tahun 2015, membuatnya dapat diakses di banyak lingkungan dan tim dari semua ukuran .

GitHub

GitHub juga mengumumkan penggunaan GraphQL dengan menyediakan GraphQL API untuk membuat integrasi, mengambil data, dan mengotomatiskan alur kerja Anda menggunakan GitHub GraphQL API. GitHub GraphQL API menawarkan kueri yang lebih tepat dan fleksibel daripada GitHub REST API.

Pinterest

Pinterest juga merupakan pengadopsi awal GraphQL. Raksasa berbagi foto ini telah secara terbuka membahas eksplorasi awal mereka terhadap GraphQL dan bagaimana mereka menggunakan teknologi GraphQL yang mendukung perusahaan miliaran dolar mereka.

Banyak perusahaan miliaran dolar lainnya seperti Intuit, Shopify, Coursera, dan Airbnb memperkuat aplikasi mereka dengan GraphQL. Dan preferensi luas untuk REST ini terus tumbuh.

Apa itu RESTful API?

REST adalah singkatan dari "Representational State Transfer," yang merupakan gaya arsitektur perangkat lunak untuk sistem hypermedia terdistribusi. Ini mendefinisikan prinsip dan batasan untuk bertukar sumber daya antara server dan klien.

Jika prinsip-prinsip ini diikuti dalam API, aplikasi API tersebut disebut sebagai “RESTful.” WordPress REST API adalah contoh utama dari ini.

Di bawah ini adalah beberapa prinsip dan batasan yang harus dipenuhi oleh API untuk disebut sebagai Restful API:

• Client-Server Decouple: Klien (frontend) dan server (backend) benar-benar terpisah dan hanya dapat berkomunikasi melalui titik akhir.
• Antarmuka Seragam: Data yang terlihat di antarmuka identik di semua perangkat.
• Statelessness: Server tidak ingat apakah permintaan saat ini dibuat untuk pertama kalinya atau tidak. Setiap kali permintaan dibuat, itu perlu menyertakan semua informasi yang diperlukan untuk memprosesnya dari awal.
• Cacheability: Caching dan penyimpanan sesi diizinkan, tetapi harus dikonfigurasi untuk memungkinkan pengguna akhir memilih keluar dari caching data.
• Arsitektur Sistem Berlapis: API harus dirancang sehingga baik klien maupun server tidak dapat mengetahui apakah mereka berkomunikasi secara langsung atau melalui perantara.

Diagram di bawah ini adalah arsitektur dasar REST. Ini menunjukkan bagaimana permintaan dan tanggapan biasanya ditangani.

Manfaat GraphQL

Berikut adalah beberapa manfaat menggunakan GraphQL, yang menggambarkan mengapa GraphQL lebih dari cukup untuk membangun aplikasi bernilai miliaran dolar berikutnya.

Mengambil Data Melalui Titik Akhir API Tunggal

Keuntungan utama GraphQL adalah kemampuannya untuk mengakses salah satu atau semua titik data melalui satu titik akhir API.

Salah satu masalah paling umum dengan RESTful API adalah memiliki terlalu banyak titik akhir untuk mengakses informasi. Di GraphQL, Anda hanya memiliki satu titik akhir, jadi Anda tidak perlu mengirim beberapa permintaan untuk mengambil informasi berbeda tentang suatu objek.

Diagram di bawah ini menggambarkan contoh yang jelas dalam mengambil sumber daya menggunakan RESTful API dan GraphQL. Anda dapat melihat bahwa hanya ada satu titik akhir untuk mengakses sumber daya di server GraphQL, sementara beberapa titik akhir API diperlukan untuk mengakses sumber daya yang berbeda di RESTful API.

Tidak ada pengambilan yang berlebihan atau pengambilan yang kurang

Masalah kelebihan atau kekurangan pengambilan adalah masalah yang diketahui dengan RESTful API. Ini adalah saat klien mengunduh data dengan menekan titik akhir yang mengembalikan struktur data tetap, atau mereka mengambil lebih atau kurang dari yang mereka harapkan.

Pengambilan yang berlebihan menyebabkan permintaan menerima — atau “mengambil” — lebih banyak data daripada yang diperlukan oleh permintaan tertentu. Bayangkan Anda mengambil semua pengguna dalam sebuah tabel dengan tujuan menampilkan nama pengguna mereka di beranda Anda. Dalam hal ini, pengambilan berlebihan akan mengembalikan semua data pada setiap pengguna, termasuk (tetapi tidak hanya) namanya.

Under-fetching relatif jarang terjadi, tetapi hal itu terjadi ketika titik akhir tertentu gagal memberikan semua informasi yang diminta. Klien perlu membuat permintaan tambahan untuk mengakses informasi lain sesuai kebutuhan.

GraphQL secara efisien memecahkan masalah over-fetching atau under-fetching dengan mengambil sumber daya yang diminta klien tanpa detail tambahan.

Penanganan Sistem Kompleks dan Layanan Mikro yang Lebih Baik

GraphQL dapat menyatukan dan menyembunyikan kompleksitas beberapa sistem terintegrasi.

Misalnya, kita ingin bermigrasi dari aplikasi backend monolitik ke arsitektur layanan mikro. GraphQL API membantu menangani komunikasi antara berbagai layanan mikro dengan menggabungkannya menjadi satu skema GraphQL.

Setelah skema ini ditentukan, frontend dan backend dapat berkomunikasi secara terpisah tanpa perubahan lebih lanjut, karena frontend mengetahui bahwa data dalam skema akan selalu sinkron di seluruh sistem.

Cepat dan Aman

Masalah pengambilan yang berlebihan dapat mengakibatkan konsumsi bandwidth yang lebih tinggi untuk klien, yang pada waktunya dapat menyebabkan kelambatan dalam aplikasi Anda. Menggunakan pola desain RESTful API lebih memakan waktu untuk memilah informasi yang dibutuhkan dari muatan yang sangat besar.

Karena kemampuan GraphQL untuk menghindari pengambilan yang berlebihan dan pengambilan yang kurang, server mengembalikan bentuk yang aman, mudah dibaca, dan dapat diprediksi yang membuat permintaan dan respons API Anda lebih cepat.

Manfaat REST

Meskipun popularitas GraphQL semakin meningkat, REST masih merupakan salah satu standar API paling populer. Mari kita intip alasannya.

• Kurva Pembelajaran: API RESTful adalah yang paling mudah dipelajari dan dipahami. Ini adalah keunggulan utamanya dibandingkan API lainnya.
• Serialisasi: REST hadir dengan pendekatan dan format yang fleksibel untuk membuat serialisasi data di JSON.
• Caching: REST API dapat mengelola beban tinggi dengan bantuan server proxy HTTP dan cache.
• Permintaan Kompleks: API REST memiliki titik akhir terpisah untuk permintaan yang berbeda, dan itu membantu membuat permintaan kompleks lebih mudah dikelola daripada di API lain
• Bersih dan Sederhana: REST API elegan, sederhana, dan bersih. Mereka mudah untuk dijelajahi.
• Prosedur HTTP Standar: REST menggunakan pemanggilan prosedur HTTP standar untuk mengambil data dan membuat permintaan.
• Klien/Server: Ini berarti logika bisnisnya dipisahkan dari presentasi. Jadi Anda dapat mengubah satu tanpa mempengaruhi yang lain.
• REST Tidak Bernegara: Semua pesan yang dipertukarkan antara klien dan server memiliki semua konteks yang diperlukan untuk mengetahui apa yang harus dilakukan dengan pesan tersebut.

Kekurangan GraphQL

Sekarang setelah kita membahas kelebihan GraphQL vs REST, mari kita telusuri beberapa kelemahan GraphQL:

• Kurva Pembelajaran yang Sulit: GraphQL tidak semudah dipelajari seperti REST. Bagian paling menantang dalam membangun GraphQL API adalah mendesain skema. Ini membutuhkan banyak waktu dan pengetahuan domain.
• Pengunggahan File: GraphQL tidak memiliki fitur pengunggahan file asli. Ini dapat diatasi dengan menggunakan pengkodean Base64, tetapi biaya penyandian dan penguraian kode dengan cara ini dapat memakan waktu dan mahal.
• Web Caching: Caching membantu mengurangi lalu lintas yang sering ke server, yang mempercepat permintaan dan proses respons dengan menjaga informasi yang sering diakses dekat dengan server. GraphQL tidak mendukung atau bergantung pada metode caching HTTP, sebaliknya bergantung pada mekanisme caching dari klien Apollo atau Relay.
• Tidak Cocok untuk Aplikasi Kecil: GraphQL mungkin bukan arsitektur API terbaik untuk membangun aplikasi kecil. Jika aplikasi Anda tidak memerlukan kueri yang lebih fleksibel yang ditawarkan oleh GraphQL, REST adalah caranya.
• Masalah Kueri Kompleks: Kemampuan GraphQL untuk memberikan klien persis apa yang diinginkannya juga dapat menyebabkan masalah propagasi kueri. Jika klien mengirimkan terlalu banyak kueri bersarang, itu dapat menyebabkan kueri yang salah dikirim, yang bisa sangat memakan waktu untuk server. Lebih baik menggunakan REST dengan titik akhir khusus untuk memenuhi permintaan tersebut.

Kekurangan REST

Sekarang, mari kita perhatikan beberapa kelemahan REST:

• Beberapa Perjalanan Pulang-Pergi: Masalah terbesar dengan REST API adalah sifat dari banyak titik akhir. Ini berarti bagi klien untuk mendapatkan semua sumber daya untuk aplikasi yang lengkap, perlu melakukan perjalanan pulang pergi yang tak terhitung banyaknya untuk mendapatkan data.
• Over-fetching dan Under-fetching: Masalah over-fetching dan under-fetching adalah kelemahan utama dalam RESTful APIS. Ini dapat menyebabkan kelambatan dalam respons karena mengambil muatan besar yang tidak diinginkan.
• Hirarki: Karena REST API dibangun di atas sumber referensi URI, mereka tidak cocok untuk sumber daya yang tidak diatur secara alami atau diakses dalam hierarki sederhana.

Mengapa Menggunakan GraphQL Alih-alih REST

Selanjutnya, kita akan membahas mengapa Anda mungkin ingin mempertimbangkan GraphQL untuk pengembangan API Anda di masa mendatang, bukan RESTful API.

Skema yang Diketik dengan Kuat

GraphQL menggunakan sistem tipe yang kuat untuk menentukan kemampuan API. Di GraphQL, bahasa definisi skema (SDL) digunakan untuk menentukan parameter seputar bagaimana klien mengakses data server. Semua API yang diekspos ke klien ditulis dalam SDL, memecahkan masalah inkonsistensi data yang terlihat di RESTful API.

Tidak Ada Over-Fetching atau Under-Fetching

Masalah pengambilan yang berlebihan atau kurang adalah masalah yang diketahui dengan RESTful API di mana klien mendapatkan kembali informasi lebih banyak atau lebih sedikit daripada yang mereka minta. GraphQL memecahkan masalah ini dengan menyediakan media bagi klien untuk menentukan informasi yang dibutuhkan, kemudian mengembalikan dengan tepat — dan hanya — informasi spesifik itu.

Beberapa Titik Akhir

Salah satu masalah terbesar RESTful API adalah memiliki terlalu banyak titik akhir untuk mengakses informasi.

Mari kita asumsikan Anda ingin mengakses pengguna tertentu melalui nomor ID mereka. Anda akan disajikan dengan titik akhir seperti /users/1 . Tetapi jika Anda ingin mengakses foto pengguna tersebut, Anda harus mengirim permintaan ke titik akhir lain, seperti /users/1/photos .

Di GraphQL, Anda memiliki satu titik akhir, dan Anda tidak perlu mengirim beberapa permintaan untuk mengambil informasi berbeda tentang pengguna.

GraphQL vs REST Showdown

Terakhir, kita akan mengeksplorasi perbedaan utama antara GraphQL dan RESTful API. Setelah itu, kita akan membahas beberapa fitur dari desain API yang baik dan membandingkan bagaimana masing-masing teknologi menanganinya.

Pertunjukan

Tidak diragukan lagi bahwa kinerja GraphQL lebih cepat daripada RESTful API karena kemampuannya untuk menyediakan satu titik akhir untuk mengakses semua sumber daya Anda. RESTful API menggunakan banyak titik akhir, yang dapat mengakibatkan latensi jaringan.

Kompleksitas Kueri

Karena titik akhir tidak dipisahkan menjadi beberapa titik akhir, kueri GraphQL dapat menjadi semakin kompleks seiring waktu. Titik akhir RESTful API, di sisi lain, dipisahkan, yang membatasi RESTful API ke kueri sederhana.

Popularitas dan Dukungan Komunitas

GraphQL adalah pola arsitektur API dan bahasa kueri yang berkembang. Meskipun masih muda, tingkat adopsi dan kumpulan sumber dayanya berkembang pesat, dan sumber daya sudah berlimpah bagi mereka yang tertarik untuk mempelajarinya sendiri.

REST, di sisi lain, sudah menawarkan dukungan komunitas yang luas dan terus digunakan oleh semua jenis perusahaan, mulai dari yang membangun layanan mikro kecil hingga yang membuat aplikasi sosial yang kompleks dan seterusnya.

Saat ini, kontes popularitas antara GraphQL vs REST adalah seri. Kedua teknologi tersebut terus digunakan secara luas dan didukung dengan baik oleh masyarakat pembangunan.

Kurva Pembelajaran

Kurva pembelajaran untuk GraphQL curam. Ini membutuhkan pengetahuan domain yang baik tentang pengembangan API dan rekayasa perangkat lunak umum. Seorang pemula yang lengkap akan kesulitan memahami GraphQL dengan cukup baik untuk membangun aplikasi yang kompleks.

Sebaliknya, REST sangat mudah untuk memulai dan membutuhkan lebih sedikit pengetahuan domain. RESTful API terintegrasi dengan baik ke sebagian besar bahasa pemrograman utama dan kerangka kerja populer, yang membuatnya sangat mudah dipelajari.

Ringkasan

GraphQL adalah teknologi baru yang mengikuti jejak pola arsitektur RESTful API, sama seperti REST yang diperkenalkan untuk memecahkan masalah dengan pola SOAP API.

GraphQL menawarkan respons yang lebih cepat, titik akhir API tunggal untuk semua kueri Anda, dan skema ketat untuk akses data yang konsisten. Alasan inilah yang membuat perusahaan multi-miliar dolar mulai beralih ke GraphQL, bahkan pada tahap awal. Namun, terlepas dari keterbatasannya, nenek moyang GraphQL REST terus mempertahankan kehadiran yang kuat di atas panggung.

Dalam panduan ini, kami telah menjelajahi semua yang perlu Anda ketahui tentang GraphQL dan RESTful API, termasuk kelebihan dan kekurangan masing-masing teknologi, untuk membantu Anda memutuskan dengan yakin mana yang Anda inginkan. Kami juga telah membahas masalah yang diketahui dengan RESTful API — seperti over-fetching, under-fetching, dan banyak titik akhir — dan bagaimana GraphQL mencoba memecahkan masalah tersebut dan meningkatkan kinerja aplikasi Anda.

Anda sekarang memiliki cukup wawasan untuk memilih apakah GraphQL vs REST sesuai untuk proyek Anda berikutnya. Beri tahu kami di bagian komentar apa yang akan Anda bangun dengan pemenang pilihan Anda!