{"meta":{"title":"GraphQL 클라이언트 사용","intro":"다양한 GraphQL 클라이언트와 라이브러리를 사용하여 실제 GitHub 데이터에 대한 쿼리를 실행할 수 있습니다.","product":"GraphQL API","breadcrumbs":[{"href":"/ko/graphql","title":"GraphQL API"},{"href":"/ko/graphql/guides","title":"안내서"},{"href":"/ko/graphql/guides/using-graphql-clients","title":"GraphQL 클라이언트 사용"}],"documentType":"article"},"body":"# GraphQL 클라이언트 사용\n\n다양한 GraphQL 클라이언트와 라이브러리를 사용하여 실제 GitHub 데이터에 대한 쿼리를 실행할 수 있습니다.\n\n> \\[!WARNING]\n> GraphQL 탐색기는 2025년 11월 11일에 설명서에서 제거되었습니다.\n> [변경 사항 공지](https://github.blog/changelog/2025-11-07-graphql-explorer-removal-from-api-documentation-on-november-7-2025)를 참조하세요.\n\n## GraphQL 클라이언트 IDE 사용\n\nGitHub의 GraphQL API에 액세스하는 데 사용할 수 있는 오픈 소스 GraphQL 클라이언트 IDE는 많이 있습니다.\n\nHTTP 메서드, 인증 및 GraphQL 호출 구조에 대한 광범위한 정보는 [GraphQL을 사용하여 통화 구성](/ko/graphql/guides/forming-calls-with-graphql)을 참조하세요.\n\n먼저, 클라이언트를 선택합니다. 일반적인 옵션으로는 GraphiQL, Insomoid, Altair(데스크톱/웹/확장)가 있습니다.\n[GraphQL 조직의 도구 디렉터리](https://graphql.org/community/tools-and-libraries/?tags=services)에서 전체 클라이언트 목록을 확인할 수 있습니다.\n\n다음의 일반적인 지침은 대부분의 GraphQL 클라이언트에서 작동합니다.\n\n1. 클라이언트를 GraphQL 엔드포인트에 연결합니다. `https://api.github.com/graphql`\n\n2. `Authorization` 헤더를 추가합니다. `Authorization: Bearer TOKEN`(`TOKEN`을 GitHub personal access token으로 교체합니다. 자세한 내용은 [개인용 액세스 토큰 관리](/ko/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens))을 참조하세요.\n\n3. 요청 메서드를 `POST`로 설정하거나, 가능하다면 클라이언트에서 제공하는 GraphQL 모드를 사용합니다.\n\n4. 편집기에서 쿼리 또는 변경 내용을 입력하고, 필요한 경우 \"Variables\" 패널에 변수를 제공합니다.\n\n   예시:\n\n   ```graphql\n   query {\n     viewer {\n       login\n     }\n   }\n   ```\n\n5. 클라이언트에서 문서 렌더링이나 자동 완성을 위해 스키마가 필요한 경우, GraphQL 내적 검사 쿼리를 통해 가져옵니다. 많은 클라이언트가 \"Docs\" 패널에서 이 작업을 자동으로 수행할 수 있습니다.\n\n   최소 내적 검사 쿼리:\n\n   ```graphql\n   query IntrospectionQuery {\n     __schema {\n       types {\n         name\n       }\n     }\n   }\n   ```\n\n6. 요청을 실행하고 JSON 응답을 검사합니다. 예시의 쿼리는 인증에 사용한 GitHub personal access token과 연결된 로그인 정보를 반환해야 합니다.\n\n클라이언트 UI를 사용하여 문서를 탐색하고, 쿼리를 실행하고, 필요에 따라 요청을 저장하세요.\n\n## GitHub CLI\n\nGitHub CLI에서 명령줄을 사용하여 GraphQL 쿼리를 실행할 수도 있습니다.\n\n1. [GitHub CLI](https://cli.github.com/manual/gh_auth_login)을 설치하고 인증합니다.\n2. GraphQL 엔드포인트에서 `https://api.github.com/graphql`을 사용하여 `gh api`에 대해 쿼리를 실행합니다.\n\n예시:\n\n```shell\ngh api graphql -f query='query { viewer { login } }'\n```\n\n이렇게 하여 인증에 사용한 GitHub personal access token과 연결된 로그인 정보를 반환해야 합니다.\n\n## 지원 요청\n\nGitHub Apps, OAuth apps, API 개발에 대한 질문, 버그 보고서 및 토론은 [GitHub의 커뮤니티 토론의 API 및 웹후크 범주](https://github.com/orgs/community/discussions/categories/api-and-webhooks)을 탐색합니다. 토론은 GitHub 직원이 검토하고 관리하며 GitHub 커뮤니티에서 답변합니다.\n\n연락처 양식을 사용하여 [GitHub 지원](https://support.github.com/)에 직접 연락하는 것이 좋습니다.\n\n* GitHub 직원의 보장된 응답\n* 중요한 데이터 또는 개인 문제와 관련된 지원 요청\n* 기능 요청\n* GitHub 제품에 대한 피드백"}