文档API 参考

Rust · 0.1.0

List All User Stats

GET /api/v1/users:stats

UserService · UserService_ListAllUserStats

基于协议生成的参考。授权与实例策略仍然生效。结构描述继承自 MIT 许可的应用接口定义;本站不会向真实服务执行示例。

访问权限

仅实例允许公开访问时才接受匿名调用;已认证调用仍受资源可见性和操作筛选规则限制。

统计遵循可读内容

笔记统计依据调用者当前受众与筛选条件计算,不是无权限限制的全局计数。GetUserStats 仅向用户本人提供 attachmentStorageBytes。不要将不同身份的结果当作具有相同可见性来比较。

请求

ListAllUserStats returns statistics for all users.

GET/api/v1/users:stats

参数

名称 / 位置类型 / 是否必需描述
state
query
string (enum)
STATE_UNSPECIFIED · NORMAL · ARCHIVED
OpenAPI 未标记为必需
Optional. The state of memos to include. Defaults to NORMAL.
filter
query
string
OpenAPI 未标记为必需
Optional. Filter to apply to memo stats. Uses the same filter syntax as ListMemos.

请求体

未声明请求体。

响应

200 · OK

application/json · ListAllUserStatsResponse

default · Default error response

application/json · Status

完整操作定义

下方保留全部已声明约束、媒体类型和响应细节。结构引用链接到完整定义。

展开 JSON 定义
{
  "tags": [
    "UserService"
  ],
  "description": "ListAllUserStats returns statistics for all users.",
  "operationId": "UserService_ListAllUserStats",
  "parameters": [
    {
      "name": "state",
      "in": "query",
      "description": "Optional. The state of memos to include. Defaults to NORMAL.",
      "schema": {
        "enum": [
          "STATE_UNSPECIFIED",
          "NORMAL",
          "ARCHIVED"
        ],
        "type": "string",
        "format": "enum"
      }
    },
    {
      "name": "filter",
      "in": "query",
      "description": "Optional. Filter to apply to memo stats.\n Uses the same filter syntax as ListMemos.",
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ListAllUserStatsResponse"
          }
        }
      }
    },
    "default": {
      "description": "Default error response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Status"
          }
        }
      }
    }
  }
}