NATSpermission.check鉴权裁决

Try it 面板需要启用 JavaScript。

业务服务携带用户与权限标识回源校验——全生态统一的鉴权点。

Request Payload

消息格式：JSON

Name	Data Type	Required	Description
userId	string	Yes	用户 ID
permission	string	Yes	权限标识，如 org:manage
orgId	string	No	组织范围权限时所属组织 ID（可选）

type RequestBody = {
  /** 用户 ID */
  userId: string
  /** 权限标识，如 org:manage */
  permission: string
  /** 组织范围权限时所属组织 ID（可选） */
  orgId?: string
}

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "permission": "org:manage",
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K"
}

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

Name	Data Type	Required	Description
allowed	boolean	Yes	是否放行

type ResponseBody = {
  /** 是否放行 */
  allowed: boolean
}

{
  "allowed": true
}

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

code	Meaning	Notes
0	成功	鉴权裁决

{
  "userId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "permission": "org:manage",
  "orgId": "01JD8SRP1N4T8W6XQ5V9XDL2Y7K"
}

{
  "id": "01JD8SWGUF4H1IE",
  "code": 0,
  "messages": [],
  "result": { "allowed": true }
}

裁决 = 角色持有 ⊨ 权限标识（含 admin 范围角色与组织范围角色的并集）；无命中即 allowed: false，不区分角色不存在与权限不足。