Firmiana
  • 简体中文

      • 管理 API

      管理 API 提供服务器管理端点。所有端点需要管理员权限。

      用户查询（Whois）

      GET /_matrix/client/v3/admin/whois/{userId}

      返回用户信息，包括设备 ID 和会话。

      {
  "user_id": "@alice:localhost",
  "devices": {
    "ABCDEF": {
      "device_id": "ABCDEF",
      "display_name": "Element Web",
      "last_seen_ts": 1625000000000,
      "last_seen_ip": "127.0.0.1"
    }
  }
}

      列出用户

      GET /_matrix/client/v3/admin/users

      返回所有注册用户。

      列出房间

      GET /_matrix/client/v3/admin/rooms

      返回所有房间，包含成员计数和状态摘要。

      踢出用户

      POST /_matrix/client/v3/admin/rooms/{roomId}/kick
      {
  "user_id": "@bob:localhost",
  "reason": "违反房间规则"
}

      封禁用户

      POST /_matrix/client/v3/admin/rooms/{roomId}/ban
      {
  "user_id": "@bob:localhost",
  "reason": "垃圾信息"
}

      停用用户

      POST /_matrix/client/v3/admin/users/{userId}/deactivate

      停用用户账户，阻止后续登录。

      房间清理

      POST /_matrix/client/v3/admin/rooms/{roomId}/purge

      移除房间中的所有事件和状态。请谨慎使用。

      用户封禁/解封

      POST /_matrix/client/v3/admin/users/{userId}/block
POST /_matrix/client/v3/admin/users/{userId}/unblock

      封禁用户使其无法与服务器交互。

      健康检查端点

      这些端点不需要认证：

      端点说明
      GET /_matrix/client/health基本健康检查
      GET /_matrix/client/health/ready就绪探针
      GET /_matrix/client/health/live存活探针
      GET /_matrix/client/stats服务器统计
      GET /_matrix/client/metricsJVM 和系统指标

      限流

      GET /_matrix/client/v3/admin/rate-limits
POST /_matrix/client/v3/admin/rate-limits

      查看和配置按 IP 限流。默认：每 60 秒窗口 100 个请求。