Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.

GraphQL API 정보

GitHub GraphQL API는 유연성과 가져오려는 데이터를 정확하게 정의하는 기능을 제공합니다.

개요

다음은 GraphQL API로 시작하고 실행할 수 있는 몇 가지 빠른 링크입니다.

GitHub의 API에 대한 자세한 내용은 "GitHub API 정보.

GraphQL 정보

GraphQL 데이터 쿼리 언어의 특성은 다음과 같습니다.

  • 사양. 사양은 API 서버에서 스키마의 유효성을 결정합니다. 스키마는 클라이언트 호출의 유효성을 결정합니다.

  • 강력한 형식. 스키마는 API의 형식 시스템 및 모든 개체 관계를 정의합니다.

  • 내적. 클라이언트는 스키마에 대한 세부 정보를 쿼리할 수 있습니다.

  • 계층적. GraphQL 호출의 모양은 반환되는 JSON 데이터의 모양을 반영합니다. 중첩된 필드를 사용하면 단일 왕복에서 지정한 데이터만 쿼리하고 받을 수 있습니다.

  • 애플리케이션 레이어. GraphQL은 스토리지 모델 또는 데이터베이스 쿼리 언어가 아닙니다. 그래프는 스키마에 정의된 그래프 구조를 나타내며, 여기서 노드는 개체를 정의하고 에지는 개체 간의 관계를 정의합니다. API는 데이터가 저장되는 방식과 관계없이 스키마 정의에 따라 애플리케이션 데이터를 트래버스하고 반환합니다.

GitHub가 GraphQL을 사용하는 이유

통합자에게 훨씬 더 많은 유연성을 제공하므로 GitHub는 GraphQL을 선택했습니다. 원하는 데이터를(원하는 데이터만) 정확하게 정의하는 기능은 기존의 REST API 엔드포인트보다 강력한 이점을 제공합니다. GraphQL을 사용하면 여러 REST 요청을 단일 호출로 바꾸어 지정한 데이터를 가져올 수 있습니다.

GitHub가 GraphQL에 투자한 이유에 대한 자세한 내용은 원래 공지 블로그 게시물을 참조하세요.

GraphQL 스키마 참조 정보

사이드바의 문서는 GitHub GraphQL 스키마에서 생성됩니다. 모든 호출은 스키마에 대해 유효성 검사를 마친 후 실행됩니다. 호출할 수 있는 데이터를 확인하려면 다음 문서를 사용합니다.

Explorer 문서 사이드바를 통해 이 동일한 콘텐츠에 액세스할 수 있습니다. GraphQL API를 성공적으로 호출하려면 문서와 스키마 유효성 검사를 모두 사용해야 할 수 있습니다.

인증 및 속도 제한 세부 정보와 같은 기타 정보는 가이드를 확인하세요.

지원 요청

GitHub Apps, OAuth Apps, API 개발에 대한 질문, 버그 보고서 및 토론은 GitHub 커뮤니티에 대한 API 및 통합 토론을(를) 탐색합니다. 토론은 GitHub 직원에 의해 조정되고 유지 관리되지만 포럼에 게시된 질문은 GitHub 직원으로부터 회신을 받을 수 없습니다.

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

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