Özel Endpoint'ler
Farklı kullanıcılar için özel erişim kurallarıyla özel şemalar oluşturun; her biri kendi endpoint'i altında kullanılabilir.
Açıklama
Bir GraphQL sunucusu normalde veri almak ve göndermek için tek bir endpoint açar.
Tek endpoint'i desteklemenin yanı sıra Gato GraphQL, özel endpoint'ler oluşturmayı da mümkün kılar; bu sayede farklı hedeflerin ihtiyaçlarını karşılamak için farklı şema yapılandırmaları sunulabilir:
- Belirli bir istemci veya kullanıcı
- Özelliklere daha fazla erişimi olan bir kullanıcı grubu (PRO kullanıcılar gibi)
- Mobil uygulama veya web sitesi gibi çeşitli uygulamalardan biri
-
- taraf API'ler
- Diğer herhangi bir hedef
Özel endpoint bir Custom Post Type'tır ve kalıcı bağlantısı (permalink) endpoint olarak kullanılır. "My endpoint" başlıklı ve my-endpoint slug'ına sahip bir endpoint /graphql/my-endpoint/ adresi altında erişilebilir olacaktır.
İstemciler
Her özel endpoint'in kendisiyle etkileşim kurmak için kendi istemci seti vardır:
✅ Bir GraphiQL istemcisi, endpoint + ?view=graphiql adresi altında kullanılabilir (örn.: /graphql/my-endpoint/?view=graphiql).
GraphiQL for Custom Endpoints modülü etkinleştirilmiş olmalıdır.
✅ Bir Interactive schema istemcisi, endpoint + ?view=schema adresi altında kullanılabilir (örn.: /graphql/my-endpoint/?view=schema).
Interactive Schema for Custom Endpoints modülü etkinleştirilmiş olmalıdır.
Özel Endpoint Oluşturma
Menüdeki Özel Endpoint'ler bağlantısına tıklandığında, oluşturulan tüm özel endpoint'lerin listesi görüntülenir:
Özel endpoint bir custom post type'tır (CPT). Yeni bir özel endpoint oluşturmak için "Add New GraphQL endpoint" düğmesine tıklayın; bu işlem WordPress düzenleyicisini açacaktır:
Özel endpoint hazır olduğunda yayınlayın; kalıcı bağlantısı endpoint URL'si haline gelir. Endpoint'e (ve kaynak ile istemcilere) ait bağlantılar "Custom Endpoint Overview" kenar çubuğu panelinde gösterilir:
Kalıcı bağlantıya ?view=source eklendiğinde, endpoint'in yapılandırması görüntülenir (kullanıcının oturum açmış olması ve kullanıcı rolünün buna erişimi olması koşuluyla):
Varsayılan olarak özel endpoint /graphql/ yoluna sahiptir ve bu değer Ayarlar üzerinden yapılandırılabilir:
Şema yapılandırması
Şemanın hangi öğeleri içerdiğini ve kullanıcıların şemaya ne düzeyde erişebileceğini şema yapılandırması belirler.
Bu nedenle bir şema yapılandırması oluşturmamız ve ardından açılır listeden seçmemiz gerekir:
Özel Endpoint'leri Kategoriye Göre Düzenleme
"Endpoint categories" kenar çubuğu panelinde, Özel Endpoint'i yönetmeye yardımcı olmak için kategoriler ekleyebiliriz:
Örneğin, endpoint'leri istemciye, uygulamaya veya gerekli diğer bilgi parçalarına göre yönetmek için kategoriler oluşturabiliriz:
Özel Endpoint'ler listesinde kategorilerini görebilir ve herhangi bir kategori bağlantısına tıklayarak ya da üstteki filtreyi kullanarak yalnızca o kategoriye ait girişleri görüntüleyebiliriz:
Özel endpoint'ler
Özel Endpoint'in durumu private olarak ayarlandığında, endpoint'e yalnızca yönetici kullanıcı erişebilir. Bu, verilerimizin erişmemesi gereken kullanıcılarla istemeden paylaşılmasını önler.
Örneğin, metriklerimizle raporlar oluşturmak için veri alma gibi uygulamayı yönetmeye yardımcı olan özel Özel Endpoint'ler oluşturabiliriz.
Şifreyle korunan endpoint'ler
Belirli bir istemci için bir Özel Endpoint oluşturursak, yalnızca o istemcinin endpoint'e erişmesini sağlamak amacıyla ek bir güvenlik katmanı olarak şifre atayabiliriz.
Şifreyle korunan bir endpoint'e ilk kez erişildiğinde (endpoint'e doğrudan erişilse de GraphiQL veya Interactive Schema istemcilerine erişilse de), şifre isteyen bir ekranla karşılaşılır:
Şifre girildikten ve doğrulandıktan sonra kullanıcı, hedeflenen endpoint'e veya istemciye erişebilir:
