Руководство по использованию инструмента

Узнайте, когда использовать этот инструмент, что он поддерживает и как его применяют пользователи.

Ключевые факты

Категория: Development
Типы ввода: text, textarea
Тип вывода: interactive
Покрытие примерами: 4
API доступен: Да

Обзор

GraphQL Playground — это интерактивный клиент в вашем браузере, позволяющий отправлять запросы и мутации на любые GraphQL-эндпоинты, передавать переменные и заголовки авторизации, а также мгновенно просматривать форматированные JSON-ответы или списки ошибок.

Когда использовать

Для быстрого тестирования GraphQL-запросов и мутаций без установки локальных приложений.
При необходимости проверить структуру схемы API и получить форматированный JSON-ответ от удаленного сервера.
Для отладки запросов с использованием динамических переменных и кастомных HTTP-заголовков, таких как токены авторизации.

Как это работает

1Укажите URL-адрес вашего GraphQL-эндпоинта в поле ввода.
2Напишите нужный GraphQL-запрос или мутацию в редакторе кода.
3Заполните JSON-переменные и HTTP-заголовки при необходимости.
4Нажмите кнопку отправки запроса, чтобы выполнить операцию и просмотреть полученный JSON-ответ.

Сценарии использования

Проверка работоспособности публичных и приватных GraphQL API.
Отладка сложных мутаций с передачей входных данных через JSON-переменные.
Быстрое прототипирование клиентских запросов перед их интеграцией в код приложения.

Сравнение альтернатив

Разбор microformats2 (h-entry/h-card), проверка Webmention/IndieAuth/Micropub/Microsub, двойное представление ActivityPub Object+Activity и маршрутизация rep…
Безопасно запускает выбранные методы Lodash для JSON.
Подкиньте любой файл сохранения — NBT из Minecraft, GVAS из Unreal Engine, контейнеры Palworld, текстовые JSON/XML/INI/Lua-сейвы, SQLite-профили — и получите…

Для кого

Подходит для

Конвертировать контент в браузере.
Повторяющиеся задачи — контент — с теми же настройками каждый раз.
Задачи, результат которых — результат.

Не подходит для

Полностью автоматизированные пакетные задачи — эта страница предназначена для интерактивной работы; для скриптов используйте конечную точку API.
Контент в других форматах — этот инструмент ожидает контент.

Граничные случаи и частые ошибки

Очень большие файлы
Большие файлы обрабатываются дольше и могут достичь пределов памяти браузера — сначала попробуйте меньший образец.
Пропуск проверки результата
Сравните первые строки или страницы результата со входными данными, прежде чем использовать его в работе.
Файлы из необычных программ экспорта
Некоторые файлы используют варианты формата, которые конвертируются нечисто, — если результат выглядит неверно, пересохраните файл в приложении, которое его создало, и попробуйте снова.

Примеры

1. Получение списка стран через публичный API

Фронтенд-разработчик

Контекст

Разработчику необходимо быстро проверить структуру данных, возвращаемых публичным сервисом Countries API, чтобы спроектировать интерфейс выбора стран.

Проблема

Нужно получить коды и названия континентов без написания кода в проекте.

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

Введите эндпоинт https://countries.trevorblades.com/, вставьте запрос со списком континентов в поле «Запрос» и нажмите кнопку отправки.

query {
  continents {
    code
    name
  }
}

Результат

Получен чистый JSON-ответ со списком континентов и их кодами для дальнейшего использования в коде.

2. Тестирование защищенной мутации создания пользователя

Бэкенд-разработчик

Контекст

Разработчик создал новую мутацию для регистрации пользователей, которая требует авторизации администратора и передачи объекта с данными.

Проблема

Необходимо проверить валидацию входных данных и корректность создания записи в базе данных.

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

Укажите рабочий эндпоинт, добавьте токен в поле «Заголовки», напишите мутацию с переменной $input и заполните JSON-переменные в соответствующем поле.

FAQ

Можно ли отправлять запросы к локальному серверу (localhost)?

Да, если ваш локальный сервер запущен и поддерживает CORS-запросы от браузера.

Как передать токен авторизации в запросе?

Добавьте заголовок в формате 'Authorization: Bearer <ваш_токен>' в поле заголовков.

Поддерживает ли инструмент переменные?

Да, вы можете передавать динамические параметры через поле 'Переменные (JSON)'.

Что делать, если запрос возвращает ошибку CORS?

Убедитесь, что на целевом сервере разрешены запросы с домена, на котором запущен данный инструмент.

Можно ли выполнять мутации (mutations) через этот интерфейс?

Да, инструмент поддерживает любые стандартные GraphQL-операции, включая query и mutation.

mutation CreateUser($input: UserInput!) {
  createUser(input: $input) {
    id
    email
  }
}

GraphQL Playground

Запустить этот инструмент

Примеры для этого инструмента

Продолжить с похожими инструментами и темами

Узнайте, когда использовать этот инструмент, что он поддерживает и как его применяют пользователи.

Ключевые факты

Обзор

Когда использовать

Как это работает

Сценарии использования

Сравнение альтернатив

Для кого

Граничные случаи и частые ошибки

Примеры

1. Получение списка стран через публичный API

2. Тестирование защищенной мутации создания пользователя

FAQ

Postman Collections - API Тестирование

Примеры Apache Arrow

Примеры Распределенного Трейсинга

Примеры AWS EventBridge

Аудитор зависимостей package.json

Визуализатор плана выполнения SQL

Просмотрщик игровых сохранений

Онлайн-утилита Lodash