Lewati ke konten utama

Pemformat Skema GraphQL

API reference

Validasi dan format ulang SDL (Schema Definition Language) GraphQL — definisi type, interface, enum, input, scalar, union, dan directive. Melaporkan kesalahan sintaks yang tepat beserta baris dan kolomnya pada skema yang tidak valid, dan mencetak ulang skema yang valid dengan indentasi konsisten 2 atau 4 spasi, dengan opsi mengurutkan type dan field secara alfabetis.

Input

Drop a file or browse
One file · text
Atau

Opsi Pemformatan

Output

Skema Terformat
 
Apakah ini membantu?

Cara lain menggunakan alat ini

REST API

curl -X POST https://api.iotools.cloud/v1/tool/graphql-schema-formatter \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "graphqlInput": "\"\"\"\nA simple blog API schema.\n\"\"\"\nschema {\n  que…",
    "indentWidth": "2",
    "sortAlphabetically": ""
  }'

Ganti dengan kunci Anda sendiri dari akun Anda. Bidang alat menjadi isi permintaan — tanpa pembungkus.

Tanyakan ke agen AI

Use the IOTools `graphql-schema-formatter` tool (GraphQL Schema Formatter) on this input:

YOUR_INPUT_HERE

Tempelkan ini ke agen mana pun yang terhubung ke server MCP IOTools, lalu tambahkan input Anda.

Widget sematan

<iframe
  src="https://iotools.cloud/embed/graphql-schema-formatter/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="Pemformat Skema GraphQL — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

Tempelkan ini di halaman Anda sendiri — gratis, tanpa kunci, cukup tautan balik.

Biaya per panggilan API/MCPMulai dari 5 kredit
Butuh kredit lebih?Lihat harga

Juga tersedia melalui

Panduan

Tempel skema GraphQL — definisi type, interface, enum, input, scalar, union, atau directive yang ditulis dalam SDL (Schema Definition Language) — dan dapatkan kembali versi yang sudah divalidasi dan diformat secara konsisten. Pemformat Skema GraphQL mengurai skema Anda dengan parser referensi yang sama dengan yang dipakai GraphQL itu sendiri, sehingga kesalahan sintaks yang sebenarnya dilaporkan lengkap dengan baris dan kolomnya, bukan tebakan, dan skema yang valid dicetak ulang dengan spasi yang rapi dan seragam.

Alat ini dibuat untuk saat skema datang dalam kondisi berantakan: disalin dari pull request, diambil dari dokumentasi, dihasilkan oleh framework code-first, atau diberikan oleh asisten AI dengan indentasi yang tidak konsisten. Tempel saja, dan dapatkan versi standarnya kembali.

Cara menggunakan

  1. Tempel SDL GraphQL Anda ke kotak input, atau unggah file .graphql, .gql, atau .sdl.
  2. Opsional: atur Lebar Indentasi (2 atau 4 spasi) dan aktifkan Urutkan Type & Field Secara Alfabetis.
  3. Salin hasil yang sudah diformat, atau unduh sebagai schema.graphql.

Pemformatan berjalan otomatis saat Anda mengetik atau mengubah opsi.

Fungsinya

  • Validasi yang sesungguhnya. Skema Anda diurai dengan graphql-js, implementasi referensi dari spesifikasi GraphQL — parser yang sama yang mendasari alat seperti Apollo Server dan GraphQL Code Generator. Skema yang rusak (titik dua yang hilang, kurung kurawal yang tidak tertutup, token yang tidak dikenal) mengembalikan pesan kesalahan asli dari parser beserta baris dan kolom tempat kesalahan terjadi, alih-alih diam-diam menghasilkan keluaran yang berantakan.
  • Indentasi yang konsisten. Pilih 2 atau 4 spasi; setiap blok — type, interface, input, enum, schema, dan deskripsi multi-baris — diindentasi ulang secara seragam.
  • Deskripsi tetap terjaga. Deskripsi satu baris ("...") maupun blok ("""...""") tetap melekat pada type atau field yang didokumentasikannya.
  • Pengurutan alfabetis opsional. Bila diaktifkan, definisi tingkat atas dikelompokkan berdasarkan jenisnya (scalar, enum, interface, union, object type, input, directive — blok schema { ... } selalu di awal) dan diurutkan berdasarkan nama di setiap kelompok; field di dalam badan type/interface/input dan nilai di dalam badan enum juga diurutkan secara alfabetis. Urutan anggota union tidak diubah, karena urutannya bisa bermakna (type utama yang dicantumkan lebih dulu).

Privasi

Semua proses berjalan di sisi klien, di browser Anda. Skema Anda tidak pernah diunggah ke server.

Apakah # comment dipertahankan?

Tidak. Lexer GraphQL menganggap komentar bergaya # tidak bermakna dan membuangnya sebelum proses parsing — komentar tersebut bukan bagian dari AST skema, sehingga pemformat apa pun yang dibangun di atas parser referensi tidak dapat mengembalikannya utuh. Deskripsi string ("..." dan """..."""), yang memang merupakan bagian dari skema, tetap dipertahankan persis seperti aslinya.

Apakah alat ini memvalidasi referensi antar-type?

Alat ini memeriksa sintaks — bahwa SDL terurai sebagai GraphQL yang valid — bukan semantik skema secara penuh (referensi type yang tidak terselesaikan, atau directive yang dipakai di tempat yang tidak dideklarasikan untuknya). Untuk validasi di level itu, bangun skema dengan library server GraphQL.

Bisakah saya memformat skema federated atau multi-file secara utuh?

Tempel semuanya sebagai satu dokumen gabungan — definisi extend type/extend interface/extend schema didukung dan diformat seperti definisi lainnya.

Apa yang sebenarnya diurutkan oleh "Urutkan Alfabetis"?

Dua hal yang berdiri sendiri: urutan definisi tingkat atas (dikelompokkan berdasarkan jenis, lalu berdasarkan nama) dan urutan field/nilai enum di dalam setiap definisi. Alat ini tidak pernah mengganti nama apa pun atau mengubah type/argumen.

graphqlsdlschemaformattervalidatorapibeautify

Suka alat-alatnya? Hilangkan iklannya.

Satu kali pembayaran menghapus semua iklan dari akun Anda, selamanya. Tanpa langganan, tanpa pelacakan.