读取当前主体与IAM上下文

POST /user/info读取App Shell使用的当前主体、角色选择上下文和能力摘要。它与/auth/me浏览器会话、/account/detail账号资料、独立/iam/me/roles及capabilities接口分别使用不同对象和封套。

调用前准备

MOI_ENDPOINT 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

需要产品身份、目标工作区及服务端验证的角色上下文。SDK以workspace-scoped typed mapping选择显式候选,CLI用配置mapping;原始HTTP头也只是未验证候选,不授予权限。非ready上下文仍可返回200用于界面恢复,不能继续使用旧角色的能力结果。

请求

curl -X POST "$MOI_ENDPOINT/user/info" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

没有业务请求体。handler不从body读取用户/角色/工作区,不消费capability_id筛选;该筛选属于独立GET capabilities接口。认证主体和候选来自已建立的调用上下文。

成功响应

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "user": "Example",
    "role": "Data analyst",
    "is_admin": false,
    "user_info": {
      "id": "456",
      "name": "Example",
      "status": "enabled",
      "reserved": false
    },
    "iam_context": {
      "roles": [
        {
          "role_id": "123",
          "role_name": "Data analyst",
          "lifecycle_version": 1,
          "selectable": true,
          "disabled_reason": ""
        }
      ],
      "default_role_id": "123",
      "default_role_version": 2,
      "explicit_role_id": "",
      "effective_role_id": "123",
      "role_context_status": "ready"
    },
    "iam_capabilities": {
      "effective_role_id": "123",
      "request_id": "req-example",
      "trace_id": "trace-example",
      "items": [
        {
          "capability_id": "action.role.create",
          "reason_code": "DENIED",
          "allowed": false,
          "all_resources": false,
          "resource_ids": []
        }
      ]
    },
    "iam_snapshot_version": "1111111111111111111111111111111111111111111111111111111111111111"
  }
}

字段

类型

说明

data.user / role

string

展示用户及角色名,不按本地名称决定allow

data.is_admin

boolean

展示管理员标记,不替代Core能力/唯一有效角色

data.user_info

object

id/name/status/reserved四项;id是此请求使用的主体引用,不能按名称与/auth/me.uid、UC subject或详情id无条件互换

data.iam_context

object

精简角色上下文,见共享合同

data.iam_capabilities

object

精简能力结果、request_id/trace_id,见共享合同

data.iam_snapshot_version

string

服务端状态指纹,供识别刷新;不是写入CAS版本或权限票据

先判断iam_context.role_context_status=ready,再按allowed和all_resources/resource_ids读取操作范围。展示字段is_admin、role或reserved不能替代实际请求鉴权。

错误与恢复

HTTP

code

当前分支

400

INVALID_ARGUMENT

工作区/当前主体或调用上下文输入不合法

404

USER_NOT_FOUND

成员未找到映射分支;membership撤销有单独403

403

ErrWorkspaceMembershipRevoked

成员关系被撤销/禁用,使用IAM本地化错误封套

403

IAM_ERROR_CODE_PERMISSION_DENIED

权限拒绝

503

IAM_ERROR_CODE_CORE_AUTHORIZE_UNAVAILABLE

Core、授权快照或当前角色依赖不可用

500

INTERNAL

事实/投影或内部错误

普通成员错误带data:null,撤销分支走IAM错误,不能强求每种失败都有同一data形状。身份中间件还可能更早拒绝请求。默认角色缺失、候选失效或角色停用可作为成功响应中的非ready状态,不能把HTTP200等同于已取得可用授权。

最后更新于