# REST 和 GraphQL API 中的堆积拉取请求

使用 GitHub REST 和 GraphQL API 以编程方式读取和管理堆积拉取请求。

> \[!NOTE] 此功能以公共预览版提供，可能会发生更改。

GitHub REST 和 GraphQL API 都公开堆积拉取请求。 REST API 支持读取和管理堆栈，而 GraphQL API 支持只读查询。

使用 API 读取拉取请求的堆栈成员身份，或为堆积拉取请求生成自己的自动化和集成。

## REST API

REST API 以两种方式公开堆积拉取请求：

* **`stack`拉取请求资源上的对象。** 当拉取请求属于堆栈时，其 REST 资源包括一个 `stack` 对象。 这样，便可以直接从拉取请求读取拉取请求的堆栈成员身份，包括堆栈的数量和大小以及拉取请求的位置和基数。
* **Stacks API。** 用于列出、读取、创建、扩展和解散堆栈的专用终结点集。 这是用于创建和修改堆栈的图面。

> \[!NOTE]
> 如果通过 API 合并并想要使用堆叠拉取请求，则需要更新代码以使用新的堆栈合并 API。 请参阅“[用于拉取请求的 REST API 终结点](/zh/enterprise-cloud@latest/rest/pulls/pulls?apiVersion=2026-03-10#merge-a-pull-request-asynchronously)”。

有关终结点、参数和架构，请参阅 [用于拉取请求的 REST API 终结点](/zh/enterprise-cloud@latest/rest/pulls/pulls)。

## GraphQL API

GraphQL API 通过类型上的`stack`只读`stackEntry`字段公开`PullRequest`拉取请求的堆栈成员身份。 使用这些字段查询拉取请求所属的堆栈及其内部位置。

GraphQL API 是堆栈的只读;没有堆栈突变。 若要创建或修改堆栈，请使用 REST API。

有关字段、对象和架构，请参阅 [拉取请求](/zh/enterprise-cloud@latest/graphql/reference/pulls#object-pullrequeststack)。

## 延伸阅读

* [堆积拉取请求 CLI 命令](/zh/enterprise-cloud@latest/pull-requests/reference/stacked-prs-cli-commands)
* [关于堆积拉取请求](/zh/enterprise-cloud@latest/pull-requests/get-started/about-stacked-prs)