Penghasil Definisi Tipe GraphQL dari JSON

Penghasil Definisi Tipe GraphQL dari JSON

Tempel objek atau array JSON apa pun dan segera dapatkan dokumen bahasa definisi skema GraphQL (SDL) yang menggambarkan bentuknya. Generator ini menjelajahi pohon JSON, menentukan tipe skalar, memberi nama objek terkait, menggabungkan variasi array-of-object, dan menghasilkan akar opsional Query tipe sehingga output siap dimasukkan ke server seperti Apollo, Yoga, Mercurius, atau graphql-go.

Mengapa Konverter JSON ke SDL GraphQL yang Deterministik Penting

Menghasilkan tipe GraphQL secara manual dari payload contoh adalah mekanis namun rentan kesalahan. Salah satu nilai nol yang terlewat, ketidakkonsistenan Int vs Float, atau pengecualian tanda tidak nol pada elemen daftar dapat menghancurkan generasi kode untuk setiap klien turunan. Generator berbasis aturan menangani contoh JSON secara identik setiap kali, sehingga aman untuk dihasilkan ulang setiap kali API berubah.

Cara Penggunaan

1. Tempel objek atau array JSON ke kotak input, atau klik Coba contoh ini untuk memuat payload representatif.
2. Tetapkan Nama Jenis Akar jika Anda ingin sesuatu selain Root.
3. Pilih sebuah Kemungkinan Nol Field strategi – ketat (!) untuk field wajib atau semua nol untuk prototipe.
4. Beralih Deteksi ID untuk mengotomatisasi promosi id dan *Id kunci ke tipe ID skalar.
5. Opsional termasuk tipe akar Query dengan field entitas tunggal dan entitas daftar.
6. Salin SDL atau unduh sebagai schema.graphql.

Fitur

• Inferensi Skalar – membedakan String, Int, Float, Booleandan ID deterministik.
• Tipe Objek Terkait – menghasilkan tipe terpisah untuk setiap objek terkait menggunakan PascalCase dari kunci field.
• Penggabungan Array of Object – menggabungkan setiap field di seluruh elemen array sehingga field opsional ditandai dengan benar.
• Pengaturan Nol vs Tidak Nol – menghasilkan tanda ketat ! atau melemahkan semua menjadi nol untuk prototipe awal.
• Deteksi ID Otomatis – meningkatkan id, userId, orderId kunci gaya menjadi ID skalar.
• Rangka Query Akar – opsional type Query { ... } dengan tanda resolver tunggal dan daftar.
• Sampingan (Saja) – data JSON tidak pernah meninggalkan browser, sehingga alat ini aman untuk payload sensitif.

Aturan Inferensi Tipe

• Angka bulat dipetakan ke Int; angka dengan bagian desimal dipetakan ke Float. Sebuah field yang dilihat sebagai keduanya dipromosikan ke Float.
• String dipetakan ke String. Dengan deteksi ID diaktifkan, kunci yang bernama id atau berakhiran Id menjadi ID.
• Boolean dipetakan ke Boolean.
• null nilai menandai field sebagai nol sehingga SDL yang dihasilkan melewatkan bagian akhir !.
• Array kosong secara default menjadi [String] karena tidak dapat ditentukan tipe elemen secara aman.
• Array of objects digabungkan menjadi satu tipe bernama; field yang tidak ditemukan di elemen mana pun menjadi nol secara otomatis.

Siapa yang Menggunakannya

• Pengembang backend yang mengelilingi endpoint REST atau file JSON dalam gateway GraphQL.
• Pengembang frontend yang membangun prototipe skema terhadap payload contoh sebelum API siap.
• Desainer API yang mengatur bentuk respons pihak ketiga sebagai kontrak berjenis data.
• Pipelines generasi kode yang membutuhkan artefak SDL yang dapat diulang dari contoh JSON stabil.