Gitlab

简介

GitLab API 开放项目、仓库、Issue、MR、CI/CD 流水线、用户、群组等能力——在 GitLab.com 或任何自建 GitLab 实例上。公开数据可匿名读取（gitlab.com 实测可用）；个人/项目令牌或 OAuth 解锁其余一切。

快速开始

公开项目——无需认证（实测可用）：

curl "https://gitlab.com/api/v4/projects?per_page=5"

项目详情：

curl "https://gitlab.com/api/v4/projects/gitlab-org%2Fgitlab"

项目 Issue：

curl "https://gitlab.com/api/v4/projects/gitlab-org%2Fgitlab/issues?per_page=5"

用户资料：

curl "https://gitlab.com/api/v4/users?username=octocat"

带个人访问令牌：

curl "https://gitlab.com/api/v4/projects?private_token=YOUR_TOKEN"

认证方式

• 匿名：公开读取免密钥可用（实测）。
• 个人访问令牌（GitLab → Preferences → Access Tokens）：更高配额、私有数据。
• OAuth：代表用户操作——列表的 OAuth 标记即指此。
• 自建实例在 https://你的实例/api/v4 暴露同一套 API。

速率限制与注意事项

• 匿名限额适中（gitlab.com 约每小时几百次）；令牌可提高。
• 项目路径需 URL 编码（gitlab-org%2Fgitlab）。
• 通过 page/per_page（最大 100）和 X-Next-Page 头分页。
• 复杂查询可用 /api/graphql 的 GraphQL API。

常见问题

GitLab API 免费吗？ 是的——公开数据可匿名读取；令牌提高配额。

需要 OAuth 吗？ 只有用户级操作需要——读取匿名或带令牌即可。

自建 GitLab 能用吗？ 可以——任何实例都有相同的 /api/v4 端点。