个人访问令牌 API

您可以阅读更多有关个人访问令牌的内容。

列出个人访问令牌

  • 引入于极狐GitLab 13.3。
  • 从极狐GitLab 旗舰版移动到免费版于 13.6。

获取个人访问令牌的列表。 

GET /personal_access_tokens
参数 类型 是否必需 描述
user_id integer/string no 用于过滤的用户的 ID
note管理员可以使用 user_id 参数按用户进行过滤。非管理员不能按除他们自己以外的任何用户进行过滤。尝试这样做会导致 401 Unauthorized 响应。
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens"

[
    {
        "id": 4,
        "name": "Test Token",
        "revoked": false,
        "created_at": "2020-07-23T14:31:47.729Z",
        "scopes": [
            "api"
        ],
        "user_id": 24,
        "last_used_at": "2021-10-06T17:58:37.550Z",
        "active": true,
        "expires_at": null
    }
]

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens?user_id=3"

[
    {
        "id": 4,
        "name": "Test Token",
        "revoked": false,
        "created_at": "2020-07-23T14:31:47.729Z",
        "scopes": [
            "api"
        ],
        "user_id": 3,
        "last_used_at": "2021-10-06T17:58:37.550Z",
        "active": true,
        "expires_at": null
    }
]

通过 ID 获取单个个人访问令牌

引入于极狐GitLab 15.1。

通过其 ID 获取单个个人访问令牌。用户可以获得自己的令牌。管理员可以获得任何令牌。 

GET /personal_access_tokens/:id
参数 类型 是否必需 描述
id integer/string yes 个人访问令牌 ID 
curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/<id>"

响应

  • 用户无权访问他们请求 ID 的令牌，或者匹配 ID 的令牌不存在：401: Unauthorized

撤回个人访问令牌

可以使用以下内容之一撤回个人访问令牌：

  • 使用个人访问令牌的 ID
  • 将其传递到 Header 中的 API

使用个人访问令牌 ID

  • 引入于极狐GitLab 13.3。
  • 从极狐GitLab 旗舰版移动到免费版于 13.6。

使用 ID 撤回个人访问令牌。 

DELETE /personal_access_tokens/:id
参数 类型 是否必需 描述
id integer/string yes 个人访问令牌 ID
note非管理员只能撤回他们自己的令牌。管理员可以撤回任何用户的令牌。
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/<personal_access_token_id>"

响应

  • 撤回成功：204: No Content
  • 撤回失败：400: Bad Request

使用请求 Header

引入于极狐GitLab 15.0。

撤回使用请求 Header 进行传递的个人访问令牌。 

DELETE /personal_access_tokens/self

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/personal_access_tokens/self"

响应

  • 撤回成功：204: No Content
  • 撤回失败：400: Bad Request

创建个人访问令牌（仅对管理员）

关于创建个人访问令牌的更多内容，请参见用户 API 文档。