GraphQL API

GitLab과 프로그래밍 방식으로 상호작용합니다.

GraphQL 은 API를 위한 쿼리 언어입니다. 필요한 정확한 데이터만 요청하여 필요한 요청 수를 줄일 수 있습니다. GraphQL 데이터는 타입으로 구성되어 있으므로 클라이언트가 클라이언트 측 GraphQL 라이브러리 를 사용하여 API를 소비하고 수동 파싱을 방지할 수 있습니다. GraphQL API는 버전이 없습니다 . 시작하기 # GitLab GraphQL API를 처음 사용하는 경우 GitLab GraphQL API 시작하기 를 참조하세요. GraphQL API 레퍼런스 에서 사용 가능한 리소스를 확인할 수 있습니다. GitLab GraphQL API 엔드포인트는 /api/graphql 에 있습니다. 대화형 GraphQL 탐색기 # 다음 중 하나에서 대화형 GraphQL 탐색기를 사용하여 GraphQL API를 탐색하세요: GitLab.com에서 . https://<your-gitlab-site.com>/-/graphql-explorer 의 GitLab Self-Managed에서. 자세한 내용은 GraphiQL 을 참조하세요. GraphQL 예제 보기 # GitLab.com의 공개 프로젝트에서 데이터를 가져오는 샘플 쿼리로 작업할 수 있습니다: 감사 보고서 생성 이슈 보드 식별 사용자 쿼리 사용자 정의 이모지 사용 시작하기 페이지에는 GraphQL 쿼리를 사용자 지정하는 다양한 방법이 포함되어 있습니다. 인증 # 일부 쿼리는 인증 없이도 액세스할 수 있지만, 다른 쿼리는 인증이 필요합니다. Mutation은 항상 인증이 필요합니다. 다음 중 하나를 사용하여 인증할 수 있습니다: 토큰 세션 쿠키 인증 정보가 유효하지 않으면 GitLab은 상태 코드 401 과 함께 오류 메시지를 반환합니다: { "errors" : [ { "message" : "Invalid token" } ] } 토큰 인증 # 다음 토큰 중 하나를 사용하여 GraphQL API로 인증하세요: OAuth 2.0 토큰 개인 접근 토큰 프로젝트 접근 토큰 그룹 접근 토큰 요청 헤더 또는 매개변수 로 전달하여 토큰으로 인증합니다. 토큰은 올바른 범위 가 필요합니다. 헤더 인증 # Authorization: Bearer <token> 요청 헤더를 사용한 토큰 인증 예시: curl --request POST \ --url "https://gitlab.com/api/graphql" \ --header "Authorization: Bearer <token>" \ --header "Content-Type: application/json" \ --data "{\"query\": \"query {currentUser {name}}\"}" 매개변수 인증 # access_token 매개변수에서 OAuth 2.0 토큰 사용 예시: curl --request POST \ --url "https://gitlab.com/api/graphql?access_token=<oauth_token>" \ --header "Content-Type: application