# 查询工作区成员详情

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

`POST /user/detail_info`读取目标工作区中已加入成员的资料、角色/标签和操作投影。这是独立详情动作，不由成员列表或当前角色列表代替。

## 调用前准备

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

使用可访问目标工作区的产品身份及X-Workspace-ID，并从已加入成员列表取得成员id或iam_user_id。不要使用邀请ID或UC subject替代。规范要求workspace_member.read；组合层对workspace_member.get显式授权，并另投影allowed_actions。

## 请求

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X POST "$MOI_ENDPOINT/user/detail_info" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d "{\"id\":\"$MEMBER_ID\"}"
```

:::::
:::::{tab-item} 参数说明

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| X-Workspace-ID | header string | 是 | 目标工作区 |
| id | body string 或 number | 是 | 成员引用；建议字符串以保留标识，支持IAM用户引用或可映射的产品主体引用 |

handler只消费id；没有按本接口校验未知字段或第二个JSON对象的严格模式，不套其它接口的严格JSON承诺。空id/不能绑定的类型被拒绝；数值绑定接受不证明任意数值都能解析到有效成员。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "allowed_actions": [
      "workspace_member.update"
    ],
    "id": "principal-example",
    "iam_user_id": "456",
    "name": "Example",
    "status": "enabled",
    "created_at": "2026-11-12T00:00:00Z",
    "updated_at": "2026-11-12T00:00:00Z",
    "reserved": false,
    "role_list": [
      {
        "id": 123,
        "name": "Data analyst",
        "status": "enabled"
      }
    ],
    "tag_list": []
  }
}
```

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| data.id | string | 资料映射得到的产品主体标识，与iam_user_id分开 |
| data.iam_user_id | string | 当前成员的IAM用户标识 |
| data.name | string | 依别名、产品显示名、邮箱或IAM引用生成的显示名 |
| data.description | string | 有值时返回的说明；保留成员的说明可能被本地化 |
| data.status | string | 详情当前读取active/disabled成员事实，投影为enabled/disabled |
| data.created_at / updated_at | string | UTC RFC3339时间 |
| data.reserved | boolean | 保留/受保护成员标记，不是对任意操作的allow凭证 |
| data.role_list | array（对象数组） | 成员角色投影；每项id为integer、name/status为string |
| data.tag_list | array（对象数组） | 成员标签投影；每项id为integer、value为string |
| data.allowed_actions | string[]（字符串数组） | 组合层按当前工作区和有效角色另做Core投影，空时仍为数组 |

角色/标签空集合为[]。allowed_actions表示当前工作区操作投影，不替代目标保护、生命周期/CAS及写入时校验；不能用角色名称或reserved自行放行。SDK模型中存在github_login/deletion字段，不等于此详情当前一定返回；常规详情未设置deletion，删除未完成信息属于成员列表投影。

:::::
::::::
:::::::

## 错误与读取范围

| HTTP | code | 当前分支 |
| --- | --- | --- |
| 400 | INVALID_ARGUMENT | 工作区头或id绑定失败 |
| 404 | USER_NOT_FOUND | 引用未映射、无成员事实或已不在当前详情可读生命周期 |
| 403 | IAM_ERROR_CODE_PERMISSION_DENIED | Core授权拒绝 |
| 503 | IAM_ERROR_CODE_CORE_AUTHORIZE_UNAVAILABLE | 授权依赖不可用 |
| 500 | INTERNAL | 其它资料/存储/投影失败 |

这些成员错误使用code/msg/data:null，msg为HTTP状态文本。成员列表中的待邀请或删除不完整条目不能据此认定可以用详情读取；DAO详情仅取active/disabled，映射回退仅在原查询NotFound时发生，存储故障不回退成别的身份。
