NATSoauth.grant.list列出用户授权记录

Try it 面板需要启用 JavaScript。

返回用户对各应用的授权记录（用户侧），或某应用的全部授权记录（开发者侧）。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	No	按用户过滤
appId	string	No	按应用过滤
page	number	No	页码，默认 1
pageSize	number	No	每页数量，默认 20，上限 100

type RequestBody = {
  /** 按用户过滤 */
  userId?: string
  /** 按应用过滤 */
  appId?: string
  /** 页码，默认 1 */
  page?: number
  /** 每页数量，默认 20，上限 100 */
  pageSize?: number
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "page": 1,
  "pageSize": 20
}

Response Payload

回复使用统一信封 {id, code, messages, result}，其 result：

Name	Data Type	Required	Description
items	array	Yes	授权记录列表
total	number	Yes	总数
page	number	Yes	当前页码
pageSize	number	Yes	每页数量

type ResponseBody = {
  /** 授权记录列表 */
  items: Record<string, unknown>[]
  /** 总数 */
  total: number
  /** 当前页码 */
  page: number
  /** 每页数量 */
  pageSize: number
}

{
  "items": [
    {
      "grantId": "01JD8SNS9N1T4W0AT5X8AGN2Y6H",
      "appId": "01JD8SNST2N5U6X1BU9YBHK4C7J",
      "appName": "Xeegam Analytics",
      "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
      "scopes": [
        "user:profile:read",
        "orgs:list"
      ],
      "grantedAt": "2026-10-14T12:00:00Z",
      "lastUsedAt": "2026-10-14T15:32:10Z"
    }
  ],
  "total": 2,
  "page": 1,
  "pageSize": 20
}

Response Code

回复使用统一信封 {id, code, messages, result}，其 code 字段：

code	Meaning	Notes
0	成功	列出用户授权记录

Examples

{ "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "page": 1, "pageSize": 20 }

{
  "id": "01JD8SWQEP4R1SO",
  "code": 0,
  "messages": [],
  "result": {
    "items": [
      {
        "grantId": "01JD8SNS9N1T4W0AT5X8AGN2Y6H",
        "appId": "01JD8SNST2N5U6X1BU9YBHK4C7J",
        "appName": "Xeegam Analytics",
        "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
        "scopes": ["user:profile:read", "orgs:list"],
        "grantedAt": "2026-10-14T12:00:00Z",
        "lastUsedAt": "2026-10-14T15:32:10Z"
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 20
  }
}