Persisted Queries

Dalam REST API, kita membuat beberapa endpoint, masing-masing mengembalikan sekumpulan data yang telah ditentukan. Dalam GraphQL API, sebaliknya, kita mengirimkan query apa pun ke satu endpoint tunggal, yang mengembalikan tepat data yang diminta.

Persisted queries adalah GraphQL queries biasa, namun disimpan di server dan diakses melalui URL mereka sendiri, sehingga meniru endpoint REST. Mereka memberikan keuntungan dari kedua API ini, sekaligus menghindari kerugiannya:

Keuntungan	Kerugian
✅ Diakses melalui `GET` atau `POST`	~~❌ Hanya dapat diakses melalui `POST`~~
✅ Dapat di-cache di server atau CDN	~~❌ Perlu menyediakan lapisan tambahan di sisi klien hanya untuk cache~~
✅ Aman: hanya data yang dimaksud yang diekspos	~~❌ Data terekspos ke siapa saja, termasuk pelaku jahat~~
✅ Tidak ada under/over fetching data, semua data diambil dalam satu permintaan	~~❌ Bisa lambat, karena aplikasi mungkin perlu beberapa permintaan untuk mengambil semua data~~
✅ Memungkinkan iterasi proyek yang cepat	~~❌ Membuat semua endpoint sangat membosankan~~
✅ Dapat didokumentasikan sendiri	~~❌ Membuat dokumentasi adalah suatu keharusan~~
✅ Menyediakan klien untuk membuat dan mempublikasikan query	~~❌ Mempublikasikan endpoint dilakukan melalui kode~~

Setelah persisted query diterbitkan, kita dapat menjalankannya melalui permalink-nya.

Persisted query dapat dijalankan melalui klien GraphiQL, atau juga langsung di browser (karena diakses melalui GET), dan kita akan memperoleh data yang diminta dalam format JSON: