Construtor de Query GraphQL — Monte Consultas Visualmente

Cole o SDL do seu schema, escolha a operação e marque os campos desejados, incluindo objetos aninhados e argumentos. A query, as variáveis e um snippet de fetch são gerados para você.

Atualizado em
Schema (SDL)
Query
Variáveis
fetch()

Seus dados nunca saem do seu computador. Todo o processamento acontece localmente no navegador.

Como usar: Construtor de Query GraphQL

  1. Abra Schema (SDL) e cole seu schema, ou use o exemplo.
  2. Escolha Query, Mutation ou Subscription.
  3. Marque os campos na árvore; expanda os objetos para escolher campos aninhados e preencha os argumentos.
  4. Copie a query gerada, o JSON de variáveis ou a chamada fetch() pronta.

Como o construtor funciona

O schema é interpretado com graphql-js e transformado em uma árvore que começa no tipo raiz da operação escolhida. Ao marcar um campo, ele entra na seleção; ao marcar um campo do tipo objeto, ele é expandido para que você escolha seus subcampos. Os argumentos preenchidos viram variáveis com os tipos GraphQL corretos ($id: ID!), então a query pode ser reutilizada e fica protegida contra injection, e o JSON de variáveis é gerado ao lado.

Dicas

  • Campos tipados como interfaces ou unions mostram suas implementações como fragments inline (... on Book).
  • Argumentos obrigatórios são marcados com !; deixe os opcionais vazios para omiti-los.
  • Use a caixa de filtro para encontrar um campo em schemas grandes.

Formate ou valide uma query existente com o formatador e validador de GraphQL, e inspecione a resposta JSON no visualizador de JSON.

Também pesquisado como: gerador de query graphql, montar query graphql, graphql query builder, construtor de mutation graphql, explorador graphql, alternativa ao graphql playground.

Ferramentas que combinam com: Construtor de Query GraphQL

  • Conversor cURL — Cole um comando curl, da documentação de uma API ou da opção “Copiar como cURL” do DevTools do seu navegador, e receba código pronto para usar em seis linguagens, com headers, corpo e autenticação preservados.
  • Validador OpenAPI / Swagger — Cole uma especificação de API para checar contra o schema oficial do OpenAPI, encontrar referências quebradas e parâmetros de path inconsistentes, e ver todos os endpoints de uma vez.
  • JSON para Tipos — Cole uma resposta da API e receba modelos prontos para uso em 8 linguagens: TypeScript, Python (dataclass, TypedDict ou Pydantic), Go, Java, C#, Kotlin, Swift e Rust.
  • Validador JSON Schema — Cole um schema e um JSON para ver exatamente quais valores quebram cada regra, ou gere um schema inicial a partir de dados de exemplo.

Perguntas frequentes

Onde consigo o SDL do meu schema?
Muitos servidores o expõem em /graphql/schema ou no repositório (schema.graphql). Você também pode exportá-lo com rover graph introspect ou npx get-graphql-schema https://api.example.com/graphql.
A ferramenta envia a query para a minha API?
Não. O construtor apenas gera texto no seu navegador. Copie o snippet de fetch para executá-lo por conta própria.
Fragments são suportados?
Campos de interface e union geram fragments inline para cada tipo possível. Fragments nomeados podem ser escritos à mão e verificados com o formatador de GraphQL.
Posso instalar o Construtor de Query GraphQL como um aplicativo da web e usá-lo offline?
Sim. O Construtor de Query GraphQL é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.

Ferramentas relacionadas