GraphQL Playground

Пишите, проверяйте и исследуйте GraphQL-запросы, мутации и схемы. Вставьте schema, чтобы просмотреть типы и поля, или загрузите примеры запросов, чтобы начать работу.

GraphQL-запрос

Переменные (JSON)

GraphQL Playground

Пишите, проверяйте и исследуйте GraphQL-запросы, мутации и схемы. Вставьте schema, чтобы просмотреть типы и поля, или загрузите примеры запросов, чтобы начать работу.

Возможности

  • Client-side query validation: brace / paren matching, operation keywords, variables JSON syntax
  • Schema explorer parses a pasted GraphQL SDL and lists types, inputs, enums
  • Built-in formatter for queries and SDL
  • This is a VALIDATOR — queries are NOT sent to a GraphQL endpoint
  • For actually executing queries, use GraphQL Playground (the original), GraphiQL, or your IDE's GraphQL extension

Как использовать

  1. Введите ваш GraphQL-запрос в редактор или нажмите кнопку примера, чтобы загрузить образец запроса.
  2. Добавьте JSON-переменные в панель переменных, если ваш запрос использует параметры.
  3. Нажмите Выполнить, чтобы проверить синтаксис запроса, или переключитесь на вкладку Обозреватель Schema, чтобы просмотреть типы.

Советы и лучшие практики

  • Queries stay in your browser. CORS makes browser-side GraphQL execution unreliable for arbitrary endpoints, so this tool is a syntax sanity-check only.
  • For real query execution, use a desktop client (Insomnia, Postman) or a server-side proxy.
  • Variable validation is JSON-syntax only — the tool doesn't cross-check variable shapes against schema types.
  • Paste your schema's SDL into the schema panel to get the type list for autocomplete-style discovery.
  • Standard operation types (query / mutation / subscription) are recognised.

Вопросы и ответы

Может ли этот инструмент действительно вызвать GraphQL API?

Нет. Из-за ограничений CORS браузера этот инструмент не может выполнять запросы к внешним API. Он проверяет синтаксис и структуру вашего запроса на стороне клиента, чтобы вы могли выявить ошибки до выполнения запросов в вашем собственном приложении или API-клиенте.

Какую валидацию он выполняет?

Playground проверяет соответствие фигурных и круглых скобок, корректные ключевые слова операций (query, mutation, subscription, fragment), пустые наборы выборки и корректный JSON в панели переменных. Для каждой найденной ошибки указывается номер строки.

Как работает Обозреватель Schema?

Вставьте документ GraphQL Schema Definition Language (SDL) и нажмите Разобрать Schema. Инструмент извлекает все типы, input-типы и enum'ы и отображает их в виде просматриваемых карточек с именем каждого поля и его типом.

Какие примеры запросов доступны?

Включены три примера запросов: базовый query пользователей, демонстрирующий вложенные поля, параметризованный запрос с переменными, показывающий директивы и пагинацию, и пример mutation с input-объектами и обработкой ошибок.

Конфиденциальны ли мои данные?

Да. Вся валидация и парсинг происходят полностью в вашем браузере. Никакие данные не отправляются ни на какой сервер. Ваши запросы, переменные и schema всегда остаются на вашем устройстве.

Могу ли я использовать это для subscription?

Вы можете писать и проверять subscription-запросы синтаксически. Однако, поскольку реальные WebSocket-соединения с внешними серверами не поддерживаются, subscription не будет выполняться. Валидатор всё равно проверит правильность синтаксиса.