{"meta":{"title":"API-интерфейсы и веб-перехватчики с накоплением запросов на вытягивание","intro":"Считывайте и управляйте запросами на вытягивание с накоплением программным образом с GitHub помощью API REST и GraphQL и веб-перехватчиков.","product":"Запросы на включение внесенных изменений","breadcrumbs":[{"href":"/ru/pull-requests","title":"Запросы на включение внесенных изменений"},{"href":"/ru/pull-requests/reference","title":"Справочные материалы"},{"href":"/ru/pull-requests/reference/stacked-pull-requests-apis-and-webhooks","title":"API-интерфейсы и веб-перехватчики с накоплением PR"}],"documentType":"article"},"body":"# API-интерфейсы и веб-перехватчики с накоплением запросов на вытягивание\n\nСчитывайте и управляйте запросами на вытягивание с накоплением программным образом с GitHub помощью API REST и GraphQL и веб-перехватчиков.\n\n> \\[!NOTE] Эта функция доступна в публичном предварительном просмотре и может измениться.\n\nGitHub ИНТЕРФЕЙСы API REST и GraphQL предоставляют запросы на вытягивание с накоплением. REST API поддерживает чтение и управление стеками, а API GraphQL поддерживает запросы только для чтения.\n\nИспользуйте API для чтения членства в стеке запроса на вытягивание или создания собственных автоматизации и интеграции для запросов на вытягивание с накоплением.\n\n## REST API\n\nREST API предоставляет запросы на вытягивание с накоплением двумя способами:\n\n* **`stack` Объект для ресурсов запроса на вытягивание.** Когда запрос на вытягивание принадлежит стеку, его ресурс REST включает `stack` объект. Это позволяет считывать членство в стеке запроса на вытягивание, включая количество и размер стека, а также положение запроса на вытягивание и базу непосредственно из запроса на вытягивание.\n* **API Stacks.** Выделенный набор конечных точек для перечисления, чтения, создания, расширения и растворения стека. Это поверхность для создания и изменения стеков.\n\nСведения о конечных точках, параметрах и схемах см. в разделе [Конечные точки REST API для запросов на вытягивание](/ru/rest/pulls/pulls).\n\n> \\[!IMPORTANT]\n> Если вы объединяетесь с помощью API и хотите использовать стекированные запросы на вытягивание, необходимо использовать новый api асинхронного слияния.\n\n### API слияния\n\nПри слиянии запроса на вытягивание с накоплением через API необходимо использовать конечную точку асинхронного слияния.\n\nСтек нельзя объединить с устаревшими синхронными конечными точками слияния или изменениями. При слиянии запроса на вытягивание с накоплением каждый запрос на вытягивание в стеке и в том числе один из запросов объединяется или помещается в очередь для объединения в базовую ветвь. Слияние стека запросов на вытягивание может включать несколько запросов на вытягивание, которые могут занять несколько минут. Из-за этого слияние выполняется в фоновом режиме при отправке запроса на слияние, а затем можно пропросить результат.\n\nПри отправке открытого PR проверяется только базовое состояние запроса на вытягивание. Правила защиты ветви и репозитория оцениваются позже, когда слияние фактически выполняется, и при опросе сообщается сбой правила. Запрос на слияние стека является атомарным, то есть либо вся группа запросов на вытягивание, либо добавляется в очередь слияния, либо ни один из них не является.\n\nДополнительные сведения см. в разделе [Конечные точки REST API для запросов на вытягивание](/ru/rest/pulls/pulls?apiVersion=2026-03-10#merge-a-pull-request-asynchronously).\n\n## GraphQL API\n\nAPI GraphQL предоставляет членство в стеке запроса на вытягивание через доступ только для `stack` чтения и `stackEntry` поля в типе `PullRequest` . Используйте эти поля для запроса стека запроса на вытягивание, к которому принадлежит запрос на вытягивание, и его положение в нем.\n\nAPI GraphQL доступен только для чтения для стеков; Изменения стека отсутствуют. Чтобы создать или изменить стеки, используйте REST API.\n\nПоля, объекты и схемы см. в разделе [Запросы на слияние](/ru/graphql/reference/pulls#object-pullrequeststack).\n\n## Webhooks\n\nКогда запрос на вытягивание принадлежит стеку, GitHub добавляет `stack` свойство в `pull_request` полезные данные события веб-перехватчика. Это позволяет приложениям и интеграции проверять целевую ветвь стека, а не только прямую родительскую ветвь запроса на вытягивание.\n\nОбъект `stack` включен в полезные `pull_request` данные веб-перехватчика для событий жизненного цикла запроса на вытягивание, которые происходят, пока запрос на вытягивание является частью стека.\n\nСм [. раздел AUTOTITLE](/ru/webhooks/webhook-events-and-payloads?actionType=stacked#pull_request).\n\n## Дополнительные материалы\n\n* [Команды CLI с накоплением запросов на вытягивание](/ru/pull-requests/reference/stacked-prs-cli-commands)\n* [Сведения о запросах на вытягивание с накоплением](/ru/pull-requests/get-started/about-stacked-prs)"}