# Использование клиентов GraphQL

Вы можете выполнять запросы к реальным данным GitHub с помощью различных клиентов и библиотек GraphQL.

> \[!WARNING]
> GraphQL Explorer был удален из документации 11 ноября 2025 года. Смотрите наше объявление [журнал изменений](https://github.blog/changelog/2025-11-07-graphql-explorer-removal-from-api-documentation-on-november-7-2025).

## Использование идентификаторов клиента GraphQL

Существует множество открытых клиентских IDE GraphQL, которые можно использовать для access GitHubGraphQL API.

См. [Формирование вызовов с помощью GraphQL](/ru/enterprise-server@3.22/graphql/guides/forming-calls-with-graphql) для подробной информации о методах HTTP, аутентификации и структуре вызовов GraphQL.

Сначала выберите клиента. Распространенные варианты: GraphiQL, Бессонница и Алтайкер (desktop/web/extension). Полный список клиентов можно просмотреть в каталоге [](https://graphql.org/community/tools-and-libraries/?tags=services)инструментов организации GraphQL.

Следующие универсальные инструкции будут работать с большинством клиентов GraphQL:

1. Наведите указатель клиента на конечную точку GraphQL: `http(s)://HOSTNAME/api/graphql`

2. Добавьте заголовок: `Authorization` (замените `Authorization: Bearer TOKEN``TOKEN` данные GitHub personal access token. Для получения дополнительной информации см. [Управление личными маркерами доступа](/ru/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)).

3. Задайте для метода `POST` запроса значение или если оно доступно, используйте режим GraphQL, предоставленный клиентом.

4. Введите запрос или мутацию в редакторе, а при необходимости укажите переменные на панели "Переменные".

   Пример:

   ```graphql
   query {
     viewer {
       login
     }
   }
   ```

5. Если клиенту нужна схема для отрисовки документации или автозаполнения, получите ее с помощью запроса introspection GraphQL. Многие клиенты могут выполнять это автоматически с панели "Документация".

   Минимальный запрос интроспекции:

   ```graphql
   query IntrospectionQuery {
     __schema {
       types {
         name
       }
     }
   }
   ```

6. Запустите запрос и проверьте ответ JSON. Запрос из примера должен возвращать имя входа, связанное с данными GitHub personal access token с проверкой подлинности.

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

## GitHub CLI

Можно также использовать командную строку с GitHub CLI для выполнения запросов GraphQL.

1. Установите и [аутентифицируйтесь с помощью GitHub CLI](https://cli.github.com/manual/gh_auth_login).
2. Выполните запрос к `http(s)://HOSTNAME/api/graphql` с помощью конечной точки GraphQL с подкомандой [`gh api`](https://cli.github.com/manual/gh_api).

Пример:

```shell
gh api graphql -f query='query { viewer { login } }'
```

Это должно вернуть имя входа, связанное с данными GitHub personal access token с проверкой подлинности.

## Запрос поддержки

Для вопросов, отчетов об ошибках и обсуждениях о GitHub Apps, OAuth appsи разработке API, изучите [Категория API и веб-перехватчиков в обсуждениях сообщества GitHub](https://github.com/orgs/community/discussions/categories/api-and-webhooks). Обсуждения модерируются и поддерживаются сотрудниками GitHub и отвечают сообществу GitHub.

В [службу поддержки GitHub](https://support.github.com/) можно обратиться напрямую через форму связи, чтобы получить:

* Гарантированный ответ от персонала GitHub
* Запросы на поддержку, связанные с конфиденциальными данными или частными проблемами
* Запросы функций
* Отзывы о продуктах GitHub