API 参考 / admin

用户详情（平台超管）

GET /api/v1/admin/users/{userId} · adminGetUser

返回用户摘要 + 所属组织 + 项目成员关系 + 活跃会话数。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

userId（必填）: string

响应字段 · 200

user（必填）: AdminUserSummary
user.id（必填）: string
user.email（必填）: string
user.status（必填）: enum；取值：active / suspended / deleted
user.platformRole（必填）: enum；取值：user / superadmin
user.emailVerified（必填）: boolean
user.orgCount（必填）: integer
user.createdAt（必填）: string
user.name: string
user.avatarUrl: string
orgs（必填）: AdminUserOrgMembership[]
orgs[].orgId（必填）: string
orgs[].orgName（必填）: string
orgs[].role（必填）: enum；取值：admin / member
orgs[].joinedAt（必填）: string
projectMemberships（必填）: AdminUserProjectMembership[]
projectMemberships[].projectId（必填）: string
projectMemberships[].projectName（必填）: string
projectMemberships[].orgId（必填）: string
projectMemberships[].orgName（必填）: string
projectMemberships[].roleName（必填）: string
projectMemberships[].membershipStatus（必填）: string
activeSessionCount（必填）: integer
isLastSuperadmin（必填）: boolean

错误

401：Problem 错误响应
403：Problem 错误响应
404：Problem 错误响应

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/users/{userId}" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "user": {
    "id": "018f3c2e-0000-7000-8000-000000000000",
    "email": "[email protected]",
    "status": "active",
    "platformRole": "user",
    "emailVerified": true,
    "orgCount": 1,
    "createdAt": "示例文本"
  },
  "orgs": [
    {
      "orgId": "018f3c2e-0000-7000-8000-000000000000",
      "orgName": "示例标题",
      "role": "admin",
      "joinedAt": "示例文本"
    }
  ],
  "projectMemberships": [
    {
      "projectId": "018f3c2e-0000-7000-8000-000000000000",
      "projectName": "示例标题",
      "orgId": "018f3c2e-0000-7000-8000-000000000000",
      "orgName": "示例标题",
      "roleName": "示例标题",
      "membershipStatus": "示例文本"
    }
  ],
  "activeSessionCount": 1,
  "isLastSuperadmin": true
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引