登录设备

3 endpoints.

列出已登录设备

GEThttp://localhost:3000/api/sessions

每一个活跃的 refresh token 家族——也就是每一台当前已登录的设备——包括发出本次请求的这一台，它会被标记出来，以免客户端不小心提出吊销自己。

需要会话 cookie 登录。任何角色的 API 令牌都会被拒绝。

响应

200当前活跃的会话。

[
  {
    "auto_name": "",
    "created_at": 0,
    "current": false,
    "custom_name": "",
    "expires_at": 0,
    "family_id": "",
    "idle_expires_at": 0,
    "ip": "",
    "last_seen_at": 0,
    "name": ""
  }
]

服务器地址

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

发送复制为 cURL

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

吊销一台已登录设备

DELETEhttp://localhost:3000/api/sessions/{family_id}

通过吊销某个会话的整个 refresh token 家族来结束它，该设备必须重新登录。需要会话 cookie 登录。

路径参数

family_idstring必填

响应

200已吊销。

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

404没有该会话。

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

服务器地址

family_idpath

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

发送复制为 cURL

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

重命名一台已登录设备

PATCHhttp://localhost:3000/api/sessions/{family_id}

为某个会话设置自定义显示名，这样设备列表读起来是「客厅平板」而不是一串 user-agent。需要会话 cookie 登录。

路径参数

family_idstring必填

请求体

application/json

响应

200已重命名。

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

404没有该会话。

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

服务器地址

family_idpath

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

发送复制为 cURL

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