GraphQL İstemcileri

Bu, GraphQL ile etkileşim kurmak için en popüler istemcilerden bazılarının derlemesi ve genel bir bakışıdır.

​

GraphiQL

GraphiQL, GraphQL queries çalıştırmak için mükemmel bir IDE'dir. GraphQL ile birlikte ilk olarak yayımlanan bu araç, GraphQL'in mevcut API'lere kıyasla nasıl üstün bir geliştirici deneyimi sunabileceğini hemen ortaya koydu; GraphQL sunucusuna karşı queries çalıştırmak için bir istemciyi ve şema belgelerini gezinmek için bir gezgini tek bir yerde birleştirdi.

GraphiQL, diğerlerinin yanı sıra şu özellikleri sunar:

• Sekmeler
• Özel başlıklar
• Söz dizimi vurgulama
• Alanlar, argümanlar, türler ve daha fazlası için akıllı tür tahmin etme
• Queries ve değişkenler için gerçek zamanlı hata vurgulama ve raporlama
• Otomatik query ve değişken tamamlama
• Queries'e otomatik zorunlu alan ekleme
• Markdown desteği ile belge gezgini ve arama
• Yerel depolama kullanarak query geçmişi
• Temalar

graphql.org/swapi-graphql adresinde bir demo mevcuttur. Düzenleyicinin yardımıyla bir GraphQL query oluşturun, iki bölme arasındaki "Execute Query" düğmesine basın ve query'ye verilen yanıtı görün.

​

Voyager

GraphQL Voyager, şema görselleştirme konusunda en temel etkileşimli araçtır; kendi belgelerinde belirttikleri gibi "GraphQL'in arkasındaki grafı" gösterir.

Şu özelliklere sahiptir:

• Graf üzerinde hızlı gezinme.
• Her tür hakkında daha ayrıntılı bilgi sağlayan sol panel.
• Relay wrapper sınıflarını kaldırarak grafı basitleştiren "Skip Relay" seçeneği.
• Grafın kökü olarak herhangi bir türü seçebilme imkânı.

ivangoncharov.github.io/graphql-voyager adresinde canlı bir demo mevcuttur.

​

DociQL

DociQL, bir GraphQL uç noktasından güzel statik HTML5 belgeleri oluşturmak için bir komut sağlar. Komutu çalıştırdıktan sonra sonuç, GraphQL şemasına ait belgeleri görüntülemek için web sunucumuza kopyalamamız gereken HTML, CSS ve JS dosyalarını içeren bir dizin olacaktır.

Oluşturulan belgeler, varsayılan olarak 3 sütunlu tek sayfalık bir düzen görüntüler: sol sütunda tüm türlere bağlantılar, ortada açıklama ve sağda örnek bir query:

Şu özelliklere sahiptir:

• Bir GraphQL şemasını almak için introspection query kullanır ve belgeleri anında oluşturur.
• "Try it now" bağlantılarıyla örnek bir istek ve yanıt oluşturur.
• Kullanıcının kullanım senaryoları tanımlamasına ve bunları etki alanına göre gruplandırmasına olanak tanır.
• Handlebars şablonları ve SCSS stilleri aracılığıyla yapılandırılabilir.
• API açıklamalarında Markdown desteği.
• Tüm cihazlarda ve ekran boyutlarında çalışan duyarlı HTML5 ve CSS3 düzeni.
• Mevcut bir web sitesine yerleştirilebilir kısmi belgeler.

Oluşturulan belgeler için wayfair.github.io/dociql adresinde bir demo mevcuttur.

​

SpectaQL

SpectaQL, DociQL'ü GraphQL için daha iyi uyarlamak amacıyla onun üzerine inşa edilmiştir. Yalnızca GraphQL'e özgü bilgileri görüntüleyen, Swagger/OpenAPI alanındaki içerikleri kaldıran (örneğin query örneğinde gösterilen "Response Content-Types: application/json" ve "Response Example (200 OK)" mesajlarını atar) bir tema sunar.

SpectaQL ayrıca çeşitli seçenekler kullanarak GraphQL şema kaynağını girmeye de olanak tanır:

• Introspection query kullanarak canlı bir uç noktadan.
• Bir introspection query sonucunu içeren dosyadan.
• SDL'deki şema tanımlarına yönlendiren bir dosyadan, dosyalardan veya glob'dan.

Oluşturulan belgeler için useanvil.com/docs/api/graphql/reference adresinde bir demo mevcuttur.

​

Postman

Postman, API'ler oluşturmak ve kullanmak için bir API platformudur. Özellikle GraphQL için tasarlanmamış olsa da Postman, GraphQL queries çalıştırmak ve GraphQL API'leri oluşturmada iş birliğini kolaylaştırmak için kullanılabilir.

Postman, tasarım, test, belgeleme ve API'lerin taklit edilmesi dahil olmak üzere API yaşam döngüsünü hızlandırmaya yardımcı olan araçlar içerir. Ayrıca API'leri çalışma alanları aracılığıyla düzenleyerek dünya genelinde dağılmış ekip üyeleriyle iş birliği yapabilirsiniz.

​

Altair

Altair, Postman'e benzer ancak GraphQL'e özel başka bir GraphQL Client IDE'sidir.

Herhangi bir GraphQL client IDE'sinin sunduğu tüm özelliklere ek olarak Altair, yerel, hazırlık ve üretim ortamları için API'ler arasında geçiş yapabilmemizi sağlayan ortamlar ve ekip üyeleriyle kolayca paylaşmak için query koleksiyonları da sunar.