{"meta":{"title":"누적 끌어오기 요청 API 및 웹후크","intro":"REST 및 GraphQL API 및 웹후크를 사용하여 프로그래밍 방식으로 GitHub 누적 끌어오기 요청을 읽고 관리합니다.","product":"끌어오기 요청","breadcrumbs":[{"href":"/ko/pull-requests","title":"끌어오기 요청"},{"href":"/ko/pull-requests/reference","title":"참조"},{"href":"/ko/pull-requests/reference/stacked-pull-requests-apis-and-webhooks","title":"누적된 PR API 및 웹후크"}],"documentType":"article"},"body":"# 누적 끌어오기 요청 API 및 웹후크\n\nREST 및 GraphQL API 및 웹후크를 사용하여 프로그래밍 방식으로 GitHub 누적 끌어오기 요청을 읽고 관리합니다.\n\n> \\[!NOTE] 이 기능은 공개 미리 보기로 제공되며 변경될 수 있습니다.\n\nGitHub REST 및 GraphQL API는 모두 누적 끌어오기 요청을 노출합니다. REST API는 스택 읽기 및 관리를 지원하지만 GraphQL API는 읽기 전용 쿼리를 지원합니다.\n\nAPI를 사용하여 끌어오기 요청의 스택 멤버 자격을 읽거나 누적 끌어오기 요청에 대한 사용자 고유의 자동화 및 통합을 빌드할 수 있습니다.\n\n## REST API\n\nREST API는 다음 두 가지 방법으로 누적 끌어오기 요청을 노출합니다.\n\n* **`stack` 끌어오기 요청 리소스의 개체입니다.** 끌어오기 요청이 스택에 속하는 경우 해당 REST 리소스에는 개체가 `stack` 포함됩니다. 이렇게 하면 끌어오기 요청에서 직접 스택의 수와 크기, 끌어오기 요청의 위치 및 기본을 포함하여 끌어오기 요청의 스택 멤버 자격을 읽을 수 있습니다.\n* **Stacks API입니다.** 스택을 나열, 읽기, 만들기, 확장 및 용해할 전용 엔드포인트 집합입니다. 스택을 만들고 수정하기 위한 표면입니다.\n\n엔드포인트, 매개 변수 및 스키마는 [끌어오기 요청에 대한 REST API 엔드포인트](/ko/rest/pulls/pulls)을 참조하세요.\n\n> \\[!IMPORTANT]\n> API를 통해 병합하고 누적 끌어오기 요청을 사용하려는 경우 새 비동기 병합 API를 사용해야 합니다.\n\n### 병합 API\n\nAPI를 통해 누적 끌어오기 요청을 병합하는 경우 비동기 병합 엔드포인트를 사용해야 합니다.\n\n스택을 레거시 동기 병합 엔드포인트 또는 변형과 병합할 수 없습니다. 누적 끌어오기 요청을 병합할 때 요청하는 끌어오기 요청을 포함하여 스택의 모든 끌어오기 요청은 병합되거나 큐에 대기되어 기본 분기로 병합됩니다. 끌어오기 요청 스택을 병합하는 데 몇 분 정도 걸릴 수 있는 여러 끌어오기 요청이 포함될 수 있습니다. 이 때문에 병합 요청을 제출할 때 병합이 백그라운드에서 실행된 다음 결과를 폴링할 수 있습니다.\n\n열려 있는 PR을 제출할 때 기본 끌어오기 요청 상태만 확인됩니다. 분기 보호 및 리포지토리 규칙은 병합이 실제로 실행되고 폴링하는 동안 규칙 실패가 실패한 결과로 보고될 때 나중에 평가됩니다. 스택 병합 요청은 원자성입니다. 즉, 끌어오기 요청의 전체 그룹이 병합되거나 병합 큐에 추가되거나 병합 큐에 추가되지 않습니다.\n\n세부 정보는 [끌어오기 요청에 대한 REST API 엔드포인트](/ko/rest/pulls/pulls?apiVersion=2026-03-10#merge-a-pull-request-asynchronously)(을)를 참조하세요.\n\n## GraphQL API\n\nGraphQL API는 읽기 전용 `stack` 및 `stackEntry` 형식의 필드를 `PullRequest` 통해 끌어오기 요청의 스택 멤버 자격을 노출합니다. 이러한 필드를 사용하여 끌어오기 요청이 속한 스택과 그 안의 위치를 쿼리합니다.\n\nGraphQL API는 스택에 대해 읽기 전용입니다. 스택 변형이 없습니다. 스택을 만들거나 수정하려면 REST API를 사용합니다.\n\n필드, 개체 및 스키마는 [끌어오기 요청](/ko/graphql/reference/pulls#object-pullrequeststack)을 참조하세요.\n\n## Webhooks\n\n끌어오기 요청이 스택 GitHub 에 속하는 경우 웹후크 이벤트 페이로드의 `stack` 개체에 속성을 추가 `pull_request` 합니다. 이를 통해 앱과 통합은 끌어오기 요청의 직접 부모 분기뿐만 아니라 스택의 대상 분기를 검사할 수 있습니다.\n\n`stack` 끌어오기 요청이 스택의 `pull_request` 일부인 동안 발생하는 끌어오기 요청 수명 주기 이벤트에 대한 웹후크 페이로드에 개체가 포함됩니다.\n\n[웹후크 이벤트 및 페이로드](/ko/webhooks/webhook-events-and-payloads?actionType=stacked#pull_request)을(를) 참조하세요.\n\n## 추가 읽기\n\n* [누적 끌어오기 요청 CLI 명령](/ko/pull-requests/reference/stacked-prs-cli-commands)\n* [스택형 풀 리퀘스트에 대하여](/ko/pull-requests/get-started/about-stacked-prs)"}