Logo
Sumber Daya
Sumber DayaKlien GraphQL

Klien GraphQL

Ini adalah kumpulan dan ikhtisar beberapa klien paling populer untuk berinteraksi dengan GraphQL.

GraphiQL

GraphiQL adalah IDE untuk mengeksekusi GraphQL queries par excellence. Dirilis pertama kali bersama GraphQL, alat ini langsung menunjukkan bagaimana GraphQL dapat menawarkan pengalaman pengembangan yang lebih unggul dibanding API yang sudah ada, dengan menggabungkan dalam satu tempat sebuah klien untuk mengeksekusi queries terhadap server GraphQL, dan sebuah penjelajah untuk menelusuri dokumentasi skema.

GraphiQL

Di antara berbagai fitur lainnya, GraphiQL menawarkan fitur-fitur berikut:

  • Tab
  • Header kustom
  • Penyorotan sintaks
  • Saran tipe cerdas untuk field, argumen, tipe, dan lainnya
  • Penyorotan dan pelaporan error secara real-time untuk queries dan variabel
  • Pelengkapan otomatis query dan variabel
  • Penambahan otomatis field yang diperlukan ke dalam queries
  • Penjelajah dokumentasi, pencarian, dengan dukungan markdown
  • Riwayat query menggunakan local storage
  • Tema

Ada demo yang tersedia di graphql.org/swapi-graphql. Buat sebuah GraphQL query dengan bantuan editor, tekan tombol "Execute Query" di tengah dua panel, dan lihat respons dari query tersebut.

Voyager

GraphQL Voyager adalah visualisator skema interaktif yang paling representatif, menampilkan (seperti yang mereka sebutkan dalam dokumentasinya) "graf di balik GraphQL".

Voyager

Alat ini hadir dengan fitur-fitur berikut:

  • Navigasi cepat pada graf.
  • Panel kiri yang memberikan informasi lebih rinci tentang setiap tipe.
  • Opsi "Skip Relay" yang menyederhanakan graf dengan menghapus kelas wrapper Relay.
  • Kemampuan memilih tipe mana saja sebagai akar graf.

Ada demo langsung di ivangoncharov.github.io/graphql-voyager.

DociQL

DociQL menyediakan perintah untuk menghasilkan dokumentasi HTML5 statis yang indah dari sebuah endpoint GraphQL. Setelah menjalankan perintah tersebut, hasilnya adalah sebuah direktori yang berisi file HTML, CSS, dan JS yang harus kita salin ke server web kita, untuk menampilkan dokumentasi skema GraphQL kita.

Dokumentasi yang dihasilkan, secara default, menampilkan tata letak satu halaman dengan 3 kolom, dengan tautan ke semua tipe di kolom kiri, deskripsi di tengah, dan contoh query di kanan:

DociQL

Alat ini hadir dengan fitur-fitur berikut:

  • Menggunakan introspection query untuk mengambil skema GraphQL dan menghasilkan dokumentasi secara langsung.
  • Menghasilkan contoh permintaan dan respons dengan tautan "Try it now".
  • Memungkinkan pengguna mendefinisikan kasus penggunaan dan mengelompokkannya berdasarkan domain.
  • Dapat dikonfigurasi melalui template Handlebars dan gaya SCSS.
  • Dukungan markdown dalam deskripsi API.
  • Tata letak HTML5 dan CSS3 responsif yang berfungsi di semua perangkat dan ukuran layar.
  • Dokumentasi parsial, yang dapat disematkan dalam situs web yang sudah ada.

Ada demo dokumentasi yang dihasilkan tersedia di wayfair.github.io/dociql.

SpectaQL

SpectaQL dibangun di atas DociQL untuk mengadaptasinya lebih baik bagi GraphQL. Alat ini menyediakan tema yang hanya menampilkan informasi relevan GraphQL, menghapus konten dari domain Swagger/OpenAPI (misalnya, membuang pesan "Response Content-Types: application/json" dan "Response Example (200 OK)" yang ditampilkan dalam contoh query).

SpectaQL

SpectaQL juga memungkinkan untuk memasukkan sumber skema GraphQL menggunakan beberapa opsi:

  • Dari endpoint langsung menggunakan introspection query.
  • Dari file yang berisi hasil introspection query.
  • Dari satu file, beberapa file, atau glob yang mengarah ke definisi skema dalam SDL.

Ada demo dokumentasi yang dihasilkan di useanvil.com/docs/api/graphql/reference.

Postman

Postman adalah platform API untuk membangun dan menggunakan API. Meskipun tidak dibuat khusus untuk GraphQL, Postman dapat digunakan untuk mengeksekusi GraphQL queries, dan memperlancar kolaborasi dalam membuat API GraphQL.

Postman

Postman mencakup alat-alat yang membantu mempercepat siklus hidup API, termasuk desain, pengujian, dokumentasi, dan mocking API. Dan kita dapat mengorganisir API melalui workspace, untuk berkolaborasi dengan anggota tim yang tersebar di seluruh dunia.

Altair

Altair adalah GraphQL Client IDE lainnya, serupa dengan Postman namun khusus untuk GraphQL.

Altair

Selain semua fitur yang ditawarkan oleh GraphQL client IDE pada umumnya, Altair juga menawarkan environment, sehingga kita dapat beralih antara menggunakan API untuk environment lokal, staging, dan produksi, serta koleksi query, untuk berbagi dengan mudah kepada anggota tim.