Persisted Queries
REST'teki gibi önceden tanımlanmış uç noktalar oluşturmak için GraphQL queries kullanın ve her iki API'nin avantajlarından yararlanın.
Click to watch tutorial video - 08:19
Bir REST API'sinde, her biri önceden tanımlanmış bir veri kümesi döndüren birden fazla uç nokta oluştururuz. Bir GraphQL API'sinde ise tam tersine, herhangi bir query'yi tek bir uç noktaya göndeririz ve bu uç nokta yalnızca istenen verileri döndürür.
Persisted queries, normal GraphQL queries'dir; ancak sunucuda depolanır ve kendi URL'leri aracılığıyla erişilir, böylece bir REST uç noktasını taklit eder. Her iki API'nin avantajlarını sunarken dezavantajlarından kaçınırlar:
| Avantajlar | Dezavantajlar |
|---|---|
✅ GET veya POST ile erişilebilir | POST ile erişilebilir |
| ✅ Sunucuda veya CDN'de önbelleğe alınabilir | |
| ✅ Güvenlidir: yalnızca amaçlanan veriler açığa çıkar | |
| ✅ Veri eksik/fazla alımı yok; tüm veriler tek bir istekte alınır | |
| ✅ Projenin hızlı yinelenmesini sağlar | |
| ✅ Kendi kendine belgelendirilebilir | |
| ✅ İstemcilerin query oluşturmasına ve yayımlamasına olanak tanır |
Persisted query yayımlandıktan sonra kalıcı bağlantısı (permalink) aracılığıyla çalıştırabiliriz.
Persisted query, GraphiQL istemcisi aracılığıyla ya da doğrudan tarayıcıda (GET ile erişilebildiğinden) çalıştırılabilir ve istenen verileri JSON formatında elde ederiz:
Persisted queries, kategoriler ve hiyerarşiler aracılığıyla yönetilebilir.
