API 令牌

4 endpoints.

列出 API 令牌

GEThttp://localhost:3000/api/tokens

每一个已签发令牌的元数据。令牌密钥本身绝不包含在内：它只在下面那个创建调用中返回一次，且不会以可恢复的形式存储。

需要会话 cookie 登录。

响应

200已签发的令牌。

[
  {
    "created_at": 0,
    "expires_at": 0,
    "id": "",
    "last_used_at": 0,
    "last_used_ip": "",
    "name": "",
    "role": "admin"
  }
]

服务器地址

该端点只接受网页会话（登录本站所用实例后浏览器自动携带的 cookie）。API 令牌会被服务端拒绝，因此这里不提供令牌输入框，上面的命令行也不带 Authorization 头。

发送复制为 cURL

填写你自己的实例地址，请求由浏览器直接发往该地址。

创建 API 令牌

POSThttp://localhost:3000/api/tokens

签发一个新令牌并返回它的密钥——这是它唯一一次被返回。请当场保存；之后无法找回，只能替换。

过期时间按服务端自己的时钟计算，而不是采用客户端提供的时间戳，因此时钟不准的客户端无法铸造出比它申请的有效期更长的令牌。

请求体

application/json

响应

200该令牌，密钥在 `data.token` 下。

null

400名称为空。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

服务器地址

该端点只接受网页会话（登录本站所用实例后浏览器自动携带的 cookie）。API 令牌会被服务端拒绝，因此这里不提供令牌输入框，上面的命令行也不带 Authorization 头。

发送复制为 cURL

填写你自己的实例地址，请求由浏览器直接发往该地址。

吊销 API 令牌

DELETEhttp://localhost:3000/api/tokens/{id}

永久吊销一个令牌。仍在使用它的任何东西会立刻开始失败；令牌无法撤销吊销，只能替换。

需要会话 cookie 登录。

路径参数

idstring必填

响应

200已吊销。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

404没有该令牌。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

服务器地址

idpath

该端点只接受网页会话（登录本站所用实例后浏览器自动携带的 cookie）。API 令牌会被服务端拒绝，因此这里不提供令牌输入框，上面的命令行也不带 Authorization 头。

发送复制为 cURL

填写你自己的实例地址，请求由浏览器直接发往该地址。

重命名 API 令牌

PATCHhttp://localhost:3000/api/tokens/{id}

修改令牌的标签。需要会话 cookie 登录。

路径参数

idstring必填

请求体

application/json

响应

200重命名后的令牌。

null

404没有该令牌。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

服务器地址

idpath

该端点只接受网页会话（登录本站所用实例后浏览器自动携带的 cookie）。API 令牌会被服务端拒绝，因此这里不提供令牌输入框，上面的命令行也不带 Authorization 头。

发送复制为 cURL

填写你自己的实例地址，请求由浏览器直接发往该地址。