添加

新添个人访问令牌

要求权限范围：TOKEN_MANAGE

资源URL

POST /user/tokens

POST参数

名称	类型	描述
name 必填	String	令牌名称
expires_in	Integer	指定访问令牌过期的天数。 一旦指定，便无法设置 expires_at
expires_at	DateTime	指定令牌的有效期。 一旦指定，就不能设置 expires_in
scopes	String[]	已创建令牌的权限范围列表。 所有权限范围都可用于此
ip_restrictions	String[]	令牌名称
workspace_restrictions	String[]	令牌名称

注

您不能创建权限范围高于授权令牌中的权限范围

信息

如果授权令牌中保存了任何IP或工作区限制，将被复制到创建的令牌中。如果要更改限制，则必须使用没有限制的授权令牌。

示例

请求

POST https://api.buddy.works/user/tokens

JSON

{
  "name": "My test token",
  "expires_in": 7,
  "scopes": [
      "WORKSPACE"
  ],
  "ip_restrictions": [
      "123.123.123.123"
  ],
  "workspace_restrictions": [
      "buddy"
  ]
}

示例响应

HTTP

Status: 200 OK
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999

JSON

{
  "url": "https://api.buddy.works/user/tokens/ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "html_url": "https://app.buddy.works/api-tokens/details/ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "id": "ZGU2Mk5ODItMTczYy00MThkLWJiOGtNmJmzFjMWVlYjAy",
  "name": "My test token",
  "token": "ed0f8927-c116-4afe-b555-c888dfd86c92",
  "expires_at": "2023-03-28T13:46:39.238118Z",
  "name": "My test token",
  "scopes": [
      "WORKSPACE"
  ],
  "ip_restrictions": [
      "123.123.123.123"
  ],
  "workspace_restrictions": [
      "buddy"
  ]
}

编辑时间：2023/03/30