GitLab REST API v4 核心基础

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

用途

掌握 GitLab REST API v4 的认证方式、请求规范、分页机制、速率限制和错误处理，为所有 API 调用提供基础能力。

何时使用

• 首次接入 GitLab API，需要选择合适的认证方式
• 需要遍历大量数据（项目/MR/Issue 等）并正确处理分页
• 遇到 429 限流错误需要实现重试逻辑
• 使用 python-gitlab 库进行自动化开发

认证方式全览

1. Personal Access Token（PAT）