# GraphQL 클라이언트 사용

다양한 GraphQL 클라이언트와 라이브러리를 사용하여 실제 GitHub 데이터에 대한 쿼리를 실행할 수 있습니다.

> \[!WARNING]
> GraphQL 탐색기는 2025년 11월 11일에 설명서에서 제거되었습니다.
> [변경 사항 공지](https://github.blog/changelog/2025-11-07-graphql-explorer-removal-from-api-documentation-on-november-7-2025)를 참조하세요.

## GraphQL 클라이언트 IDE 사용

GitHub의 GraphQL API에 액세스하는 데 사용할 수 있는 오픈 소스 GraphQL 클라이언트 IDE는 많이 있습니다.

HTTP 메서드, 인증 및 GraphQL 호출 구조에 대한 광범위한 정보는 [GraphQL을 사용하여 통화 구성](/ko/enterprise-server@3.22/graphql/guides/forming-calls-with-graphql)을 참조하세요.

먼저, 클라이언트를 선택합니다. 일반적인 옵션으로는 GraphiQL, Insomoid, Altair(데스크톱/웹/확장)가 있습니다.
[GraphQL 조직의 도구 디렉터리](https://graphql.org/community/tools-and-libraries/?tags=services)에서 전체 클라이언트 목록을 확인할 수 있습니다.

다음의 일반적인 지침은 대부분의 GraphQL 클라이언트에서 작동합니다.

1. 클라이언트를 GraphQL 엔드포인트에 연결합니다. `http(s)://HOSTNAME/api/graphql`

2. `Authorization` 헤더를 추가합니다. `Authorization: Bearer TOKEN`(`TOKEN`을 GitHub personal access token으로 교체합니다. 자세한 내용은 [개인용 액세스 토큰 관리](/ko/enterprise-server@3.22/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens))을 참조하세요.

3. 요청 메서드를 `POST`로 설정하거나, 가능하다면 클라이언트에서 제공하는 GraphQL 모드를 사용합니다.

4. 편집기에서 쿼리 또는 변경 내용을 입력하고, 필요한 경우 "Variables" 패널에 변수를 제공합니다.

   예시:

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

5. 클라이언트에서 문서 렌더링이나 자동 완성을 위해 스키마가 필요한 경우, GraphQL 내적 검사 쿼리를 통해 가져옵니다. 많은 클라이언트가 "Docs" 패널에서 이 작업을 자동으로 수행할 수 있습니다.

   최소 내적 검사 쿼리:

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

6. 요청을 실행하고 JSON 응답을 검사합니다. 예시의 쿼리는 인증에 사용한 GitHub personal access token과 연결된 로그인 정보를 반환해야 합니다.

클라이언트 UI를 사용하여 문서를 탐색하고, 쿼리를 실행하고, 필요에 따라 요청을 저장하세요.

## GitHub CLI

GitHub CLI에서 명령줄을 사용하여 GraphQL 쿼리를 실행할 수도 있습니다.

1. [GitHub CLI](https://cli.github.com/manual/gh_auth_login)을 설치하고 인증합니다.
2. GraphQL 엔드포인트에서 `http(s)://HOSTNAME/api/graphql`을 사용하여 `gh api`에 대해 쿼리를 실행합니다.

예시:

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

이렇게 하여 인증에 사용한 GitHub personal access token과 연결된 로그인 정보를 반환해야 합니다.

## 지원 요청

GitHub Apps, OAuth apps, API 개발에 대한 질문, 버그 보고서 및 토론은 [GitHub의 커뮤니티 토론의 API 및 웹후크 범주](https://github.com/orgs/community/discussions/categories/api-and-webhooks)을 탐색합니다. 토론은 GitHub 직원이 검토하고 관리하며 GitHub 커뮤니티에서 답변합니다.

연락처 양식을 사용하여 [GitHub 지원](https://support.github.com/)에 직접 연락하는 것이 좋습니다.

* GitHub 직원의 보장된 응답
* 중요한 데이터 또는 개인 문제와 관련된 지원 요청
* 기능 요청
* GitHub 제품에 대한 피드백