记录Gitlab常用API

GitLab 是一个用于仓库管理系统的开源项目，使用Git作为代码管理工具，并在此基础上搭建起来的Web服务。
很多公司都在用Gitlab。有时候开发业务需要调用Gitlab上的一些接口，比如获取当前用户、仓库分组、工程目录、提交记录、分支、tag、readme等，下面记录一下Gitlab开放api。

接口地址

1、访问自己部署的Gitlab服务器
http://ip:端口/help/api/README.md，打开Gitlab该地址会出现api的访问目录，如下（图太长了，就截了部分）：

由于接口太多了，所以下面只介绍几个常用的，大家也可以在使用的时候点进每一项看看描述信息和使用方式。

2、使用官网地址

官网API使用介绍介绍了如何登录认证和使用。
官方API介绍了API的使用。

注意问题

登录

访问http://ip:端口/help/api/README.md#personal-access-tokens，可以看到Authentication认证的几种方式：

• OAuth2 tokens：可以每次使用用户名和密码认证获取access_token；
• Personal access tokens：可以使用管理端登录后设置；
• Session cookie：不常用；

调用Gitlab服务接口需要传一个请求头：Private-Token。
而Private-Token的获取首先需要登录，老版Gitlab可以通过用户名、密码登录，新版需要使用Personal Access Tokens来授权访问。
Personal Access Tokens的生成在网页端登录后的右上角用户头像下拉菜单的settings页面，再点击settings页面的左侧菜单栏中的Access Tokens选项，就会出现创建Personal Access Tokens的页面。

v3和v4

Gitlab从9.0版本已经大多使用v4API，从9.5版本开始不支持v3API，从11.0已经完全移除v3API。
v3升级v4