GitLab GraphQL API

来源：https://docs.gitlab.com/api/graphql/ / https://docs.gitlab.com/api/graphql/getting_started/ 版本基准：GitLab 17.x（self-managed / SaaS）

用途

使用 GraphQL 精确查询所需数据，减少网络请求次数，在单次请求中获取跨资源的关联数据。适合需要获取嵌套关系数据的复杂场景。

何时使用

• 需要在一次请求中获取多层嵌套数据（如项目 -> MR -> Pipeline -> Jobs）
• REST API 需要多次请求拼凑的数据，GraphQL 一次搞定
• 需要精确控制返回字段，减少传输数据量
• 执行批量 Mutation（如批量添加 label/emoji）
• 探索 GitLab 数据模型和可用字段

端点与认证