---
title: "后台用户列表"
method: GET
path: "/v1/admin/users"
tags: ["AdminService"]
---

# 后台用户列表

`GET /v1/admin/users`

ListUsers 列出用户

## Query parameters

- `page` integer
- `size` integer
- `status` string
- `accountType` integer
- `email` string
- `role` string
- `keyword` string
- `sortBy` string
- `sortOrder` string
- `limit` integer
- `accountTypes` integer[]

## Response `200`

OK

- AdminV1ListUsersReply
  - `items` AdminV1UserAdminInfo[]
    - `accountType` integer — account_type 保留作为内部 / 老路径数字码（1=C端 2=B端员工 3=代理商 4=企业管理员 5=企业成员）。 新前端使用 role 字符串；这里保留是为了 wire format 兼容性。
    - `allowTokenBindSource` boolean — allow_token_bind_source 是否允许该用户的 API Key 绑定渠道资源。 启用后，该用户创建的 API Key 可设置 channel_source_id 实现令牌级路由； 禁用时，后端忽略 API Key 的 channel_source_id 绑定（即使已设置也不生效）。
    - `apiCallCount` string — api_call_count 是从 usage_logs 表聚合的累计调用次数。
    - `balanceMicros` string — 钱包聚合字段（list/get 时由 data 层 EnrichWalletAggregates 填充）。 单位 micros 强制写在字段名里，避免对端误用元单位计算。
    - `bannedAt` string, date-time — 封禁元数据（仅 status='banned' 时有值）。 banned_until=nil 表示永久封禁；非空时为预定的自动解封时间。
    - `bannedReason` string
    - `bannedUntil` string, date-time
    - `createdAt` string, date-time
    - `displayName` string
    - `email` string
    - `frozenBalanceMicros` string
    - `id` string
    - `inviteCount` string
    - `inviteRewardMicros` string
    - `inviterId` string
    - `inviterName` string
    - `lastLoginAt` string, date-time
    - `phone` string
    - `realnameStatus` string — realname_status 是个人实名认证状态：unverified / processing / verified。
    - `realnameVerifiedAt` string, date-time — realname_verified_at 是个人实名认证通过时间；未认证为空。
    - `remark` string
    - `roles` AdminV1Role[] — roles 是用户当前生效的 RBAC 角色（已过滤过期绑定/停用/已删除角色）。 前端用 role_id 调 iam GetRole (/v1/iam/roles/{id}) 查权限以驱动菜单/按钮。
      - `name` string — 角色显示名
      - `roleId` string — 角色 ID，与 iam GetRole (/v1/iam/roles/{id}) 入参一致
    - `status` string — status 是字符串状态枚举：'active' / 'banned'。 历史接口之前返回 int32 status，本次改为统一字符串；调用方应迁移。
    - `tierId` string — 用户绑定的等级（原始绑定值，非生效等级）。tier_id=0 表示未绑定， 运行时回落系统默认等级；企业成员（account_type=5）恒为 0， 等级在请求时动态跟随 team owner（见 tier.proto / PR#382 语义）。
    - `tierName` string — 等级名称；未绑定为空串。list/get 由 data 层批量填充，填充失败降级为空（WARN 不阻断）。
    - `totalSpentMicros` string
    - `username` string
  - `page` integer
  - `size` integer
  - `total` string

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)