Skip to main content

GraphQL 클라이언트 사용

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

GraphQL 클라이언트 IDE 사용

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

HTTP 메서드, 인증, GraphQL 호출 구조에 대한 자세한 내용은 GraphQL을 사용하여 통화 구성을(를) 참조하세요.

먼저, 클라이언트를 선택합니다. 일반적인 옵션으로는 GraphiQL, Insomoid, Altair(데스크톱/웹/확장)가 있습니다. GraphQL 조직의 도구 디렉터리에서 전체 클라이언트 목록을 확인할 수 있습니다.

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

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

  2. Authorization 헤더를 추가합니다. Authorization: Bearer TOKEN(TOKEN을 GitHub personal access token으로 교체합니다. 자세한 내용은 개인용 액세스 토큰 관리을(를) 참조하세요.)

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

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

    예시:

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

    최소 내적 검사 쿼리:

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

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

GitHub CLI

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

  1. GitHub CLI를 설치하고 인증하세요.
  2. gh api 하위 명령을 사용하여 GraphQL 엔드포인트를 통해 http(s)://HOSTNAME/api/graphql에 대한 쿼리를 실행합니다.

예시:

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

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

지원 요청

GitHub Apps, OAuth apps, API 개발에 대한 질문, 버그 보고서 및 토론은 GitHub의 커뮤니티 토론의 API 및 웹후크 범주을 탐색합니다. 토론은 GitHub 직원이 검토하고 관리하며 GitHub 커뮤니티에서 답변합니다.

연락처 양식을 사용하여 GitHub 지원에 직접 연락하는 것이 좋습니다.

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