令牌

令牌(Token)

目录

令牌(Token)资源是一个 whoami 端点:它返回关于本次请求所用令牌的元数据。它相当于 v1 的 auth / check_auth 端点,便于验证令牌并查明它持有哪些作用域。

  • 基础路径: /api/v2/token
  • 作用域: 无——任何有效令牌都可以读取自身的元数据
  • 起始版本: 3.1.0

注意

请先阅读 API v2 概览,了解认证、响应封装与错误码。

端点

动词 路径 作用域 用途 起始版本
GET /api/v2/token 任何有效令牌 当前令牌的元数据 3.1.0

该端点仍然需要一个有效令牌(无效或已过期的令牌会返回 401),但不需要特定作用域。

curl "https://<WAVELOG_URL>/index.php/api/v2/token" \
     -H "Authorization: Bearer wl2_your_token_here"
{
  "data": {
    "id": 15,
    "name": "my logger",
    "owner": "N0CALL",
    "user_id": 1,
    "scopes": [ "qso:read", "qso:write", "lookup:read" ],
    "expires_at": "2026-08-16 12:05:50"
  }
}

对于永不过期的令牌,expires_at 为 null。

提示

想找 Wavelog 的版本号?那可以从 统计 资源获取,而不是这里。

Wavelog 手册(中文版) / 令牌 0 字 0 行 bg8lng
2026-10-21T12:42:36.407607579Z 2026-10-21T12:44:04.873836139Z