管理员
有关管理员管理的操作。
这些端点仅针对自托管实例的 管理员 用户开放，不适用于 Umami 云。
端点
GET /api/admin/users
GET /api/admin/websites
GET /api/admin/teamsGET /api/admin/users
返回所有用户。
参数
-
search：（字符串 | 可选）搜索文本。 -
page：（数字 | 可选，默认 1）确定页码。 -
pageSize：（数字 | 可选，默认 20）确定返回多少结果。示例响应
{
"data": [
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"username": "member",
"role": "user",
"logoUrl": null,
"displayName": null,
"createdAt": "2025-10-10T23:09:16.524Z",
"updatedAt": "2025-10-10T23:09:16.524Z",
"deletedAt": null,
"_count": {
"websites": 0
}
},
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"username": "admin",
"role": "admin",
"logoUrl": null,
"displayName": null,
"createdAt": "2025-09-15T17:47:16.421Z",
"updatedAt": null,
"deletedAt": null,
"_count": {
"websites": 1
}
}
],
"count": 2,
"page": 1,
"pageSize": 20,
"orderBy": "createdAt"
}GET /api/admin/websites
返回所有网站。
参数
-
search：（字符串 | 可选）搜索文本。 -
page：（数字 | 可选，默认 1）确定页码。 -
pageSize：（数字 | 可选，默认 20）确定返回多少结果。示例响应
{
"data": [
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "My Website",
"domain": "mywebsite.com",
"shareId": null,
"resetAt": null,
"userId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"teamId": null,
"createdBy": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"createdAt": "2025-09-16T19:59:32.957Z",
"updatedAt": "2025-09-16T19:59:32.957Z",
"deletedAt": null,
"user": {
"username": "admin",
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
},
"team": null
}
],
"count": 1,
"page": 1,
"pageSize": 20
}GET /api/admin/teams
返回所有团队。
参数
-
search：（字符串 | 可选）搜索文本。 -
page：（数字 | 可选，默认 1）确定页码。 -
pageSize：（数字 | 可选，默认 20）确定返回多少结果。示例响应
{
"data": [
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Umami Software, Inc",
"accessCode": "xxxxxxxxxxxxxx",
"logoUrl": null,
"createdAt": "2025-09-24T22:08:35.259Z",
"updatedAt": "2025-09-24T22:08:35.259Z",
"deletedAt": null,
"members": [
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"teamId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"role": "team-owner",
"createdAt": "2025-09-24T22:08:35.302Z",
"updatedAt": "2025-09-24T22:08:35.302Z",
"user": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"username": "admin"
}
},
{
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"teamId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"userId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"role": "team-member",
"createdAt": "2025-10-10T23:41:09.030Z",
"updatedAt": "2025-10-10T23:41:09.030Z",
"user": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"username": "member"
}
}
],
"_count": {
"websites": 1,
"members": 2
}
}
],
"count": 1,
"page": 1,
"pageSize": 20
}