# 用户资料

返回用户资料。

```json
{
  "openapi": "3.1.1",
  "info": {
    "title": "用户资料",
    "version": "1.0.0"
  },
  "paths": {
    "/users/{id}": {
      "get": {
        "operationId": "getPublicUser",
        "summary": "用户资料",
        "description": "返回用户资料。",
        "security": [],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiVersion"
          },
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "账号 ID。",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "ef57cc6f-f068-11ef-a5bf-d00d12c6f2dd"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "User profile.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserProfileResult"
                },
                "example": {
                  "response": {
                    "avatar": "447f9470-325b-4e0a-ada0-f4f1659ef805.png",
                    "id": 1,
                    "username": "GAMEMONITORING",
                    "banner": "469ebf64-206c-4374-a742-7730ea227f95.webp",
                    "connections": [
                      {
                        "account_id": "76561197960287930",
                        "account_level": 1,
                        "id": 220354,
                        "name": "Rabscuttle",
                        "platform": {
                          "icon": null,
                          "id": 3,
                          "name": "Steam",
                          "url": "steam"
                        }
                      }
                    ],
                    "created": 1435235037,
                    "last_online": 1793734264,
                    "uuid": "ef57cc6f-f068-11ef-a5bf-d00d12c6f2dd"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "description": "User not found."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ErrorEnvelope": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "description": "HTTP 状态码。"
              },
              "message": {
                "type": "string",
                "description": "使用 API 语言的错误消息。文字可能变化；请按状态码处理错误。"
              },
              "data": {
                "description": "可用时提供额外错误详情。"
              }
            }
          }
        }
      },
      "Server": {
        "type": "object",
        "properties": {
          "add_date": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "app": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  "name": {
                    "type": "string"
                  },
                  "steam_id": {
                    "description": "Steam App ID of the game. Use this as game_steam_id when searching servers.",
                    "anyOf": [
                      {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "string"
                          }
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          },
          "color": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "connect": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "domain": {
            "type": [
              "string",
              "null"
            ]
          },
          "game": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "hide_address": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "hide_query": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "icon": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          },
          "ip": {
            "type": [
              "string",
              "null"
            ]
          },
          "language": {
            "type": [
              "string",
              "null"
            ]
          },
          "last_update": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "map": {
            "type": [
              "string",
              "null"
            ]
          },
          "maxplayers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "numplayers": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "official": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "points": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "port": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "private": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "project_id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "pve": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "pvp": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "request": {
            "type": [
              "string",
              "null"
            ]
          },
          "secured": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "steam_id": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "string"
                  }
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "请保持字符串标识符为字符串，避免精度丢失。"
          },
          "version": {
            "type": [
              "string",
              "null"
            ]
          },
          "votes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "wipe": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "ban_reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "banned": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "boosts": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "bots": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "服务器说明，以 JSON 字符串编码的块列表存储。"
          },
          "disabled_modules": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "gamemode": {
            "type": [
              "string",
              "null"
            ]
          },
          "hidden": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "last_offline": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "last_online": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "list_hidden": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1
              }
            ]
          },
          "map_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "mods": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name"
              ],
              "additionalProperties": {}
            }
          },
          "next_wipe": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Unix 时间戳，单位为秒（UTC）。"
          },
          "parked": {
            "type": "boolean"
          },
          "position_game": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "wipe_period": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "id",
          "parked"
        ],
        "additionalProperties": {}
      },
      "ServerEnvelope": {
        "type": "object",
        "required": [
          "response"
        ],
        "properties": {
          "response": {
            "$ref": "#/components/schemas/Server",
            "description": "成功响应将结果放在 response 中。列表可能是数组或带 items 的对象；请查看此操作的结构。"
          }
        }
      },
      "UserProfileResult": {
        "type": "object",
        "required": [
          "response"
        ],
        "properties": {
          "response": {
            "type": "object",
            "required": [
              "id",
              "uuid",
              "username",
              "avatar",
              "banner",
              "created",
              "last_online"
            ],
            "properties": {
              "id": {
                "type": "integer",
                "minimum": 1,
                "description": "Numeric profile ID."
              },
              "uuid": {
                "type": "string",
                "format": "uuid",
                "description": "Account ID."
              },
              "username": {
                "type": "string"
              },
              "avatar": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "banner": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "created": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "last_online": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "connections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "account_id",
                    "account_level",
                    "name"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": 1
                    },
                    "account_id": {
                      "type": "string"
                    },
                    "account_level": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "name": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "platform": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "required": [
                        "id",
                        "name",
                        "icon",
                        "url"
                      ],
                      "properties": {
                        "id": {
                          "type": "integer",
                          "minimum": 1
                        },
                        "name": {
                          "type": "string"
                        },
                        "icon": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "url": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "ServerCreateResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "object",
            "properties": {
              "connect": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "game": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "id": {
                "type": "integer",
                "minimum": 1
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "request": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": [
                  "boolean",
                  "null"
                ]
              }
            },
            "required": [
              "connect",
              "game",
              "id",
              "name",
              "request",
              "status"
            ]
          }
        },
        "required": [
          "response"
        ]
      },
      "ServerPlayersResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "object",
            "properties": {
              "items": {
                "description": "如果会话历史查询未返回玩家，`items` 会包含最近一次服务器查询的完整玩家列表（若可用）。",
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "avatar": {
                      "type": "string"
                    },
                    "created": {
                      "type": [
                        "number",
                        "string",
                        "null"
                      ]
                    },
                    "last_online": {
                      "type": [
                        "number",
                        "string",
                        "null"
                      ]
                    },
                    "last_session_time": {
                      "type": "number"
                    },
                    "name": {
                      "type": [
                        "number",
                        "string",
                        "null"
                      ]
                    },
                    "user": {
                      "type": [
                        "object",
                        "null"
                      ],
                      "properties": {
                        "avatar": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "username": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    },
                    "username": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "avatar",
                    "last_session_time",
                    "username"
                  ]
                }
              }
            },
            "required": [
              "items"
            ]
          }
        },
        "required": [
          "response"
        ]
      },
      "ServerPostsResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          }
        },
        "required": [
          "response"
        ]
      },
      "ServerPlayerStatsResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "avg_players": {
                      "type": "number"
                    },
                    "date": {
                      "type": "number"
                    },
                    "maps": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "max_players": {
                      "type": "number"
                    },
                    "min_players": {
                      "type": "number"
                    },
                    "x": {
                      "type": "number"
                    },
                    "y": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "avg_players",
                    "date",
                    "maps",
                    "max_players",
                    "min_players",
                    "x",
                    "y"
                  ]
                }
              }
            },
            "required": [
              "items"
            ]
          }
        },
        "required": [
          "response"
        ]
      },
      "ProjectPlayerStatsResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "avg_players": {
                      "type": "number"
                    },
                    "date": {
                      "type": "number"
                    },
                    "max_players": {
                      "type": "number"
                    },
                    "min_players": {
                      "type": "number"
                    },
                    "x": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "avg_players",
                    "date",
                    "max_players",
                    "min_players",
                    "x"
                  ]
                }
              }
            },
            "required": [
              "items"
            ]
          }
        },
        "required": [
          "response"
        ]
      },
      "VoteDetailsEnvelope": {
        "type": "object",
        "properties": {
          "response": {
            "$ref": "#/components/schemas/VoteDetails"
          }
        }
      },
      "VoteDetails": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "9824cabb-2203-437e-9b6c-aba43dde3e4b"
          },
          "entity_id": {
            "type": "number",
            "description": "ID of the entity that received the vote.",
            "example": 1
          },
          "entity_type": {
            "type": "string",
            "description": "Type of the entity that received the vote.",
            "enum": [
              "server",
              "project"
            ],
            "example": "server"
          },
          "nickname": {
            "type": [
              "string",
              "null"
            ],
            "example": "PlayerName"
          },
          "created_at": {
            "type": "number",
            "example": 1710000000
          },
          "expires_at": {
            "type": "number",
            "example": 1710086400
          },
          "server": {
            "type": [
              "object",
              "null"
            ],
            "description": "Present for `server` votes.",
            "properties": {
              "id": {
                "type": [
                  "number",
                  "string",
                  "null"
                ],
                "example": 1
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "example": "Public Server"
              },
              "icon": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "game": {
                "type": [
                  "number",
                  "null"
                ],
                "example": 730
              }
            }
          },
          "project": {
            "type": [
              "object",
              "null"
            ],
            "description": "Present for `project` votes.",
            "properties": {
              "id": {
                "type": "number",
                "example": 1
              }
            }
          },
          "user": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": [
                  "number",
                  "string",
                  "null"
                ]
              },
              "uuid": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "username": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "avatar": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "webhook": {
            "type": [
              "object",
              "null"
            ],
            "description": "Present only when the requester can view webhook delivery details.",
            "properties": {
              "attempted_at": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "event_id": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "event_type": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "server.vote",
                  "project.vote",
                  null
                ],
                "example": "project.vote"
              },
              "is_test": {
                "type": [
                  "boolean",
                  "null"
                ]
              },
              "request_body": {
                "type": [
                  "object",
                  "null"
                ]
              },
              "response_body": {},
              "response_code": {
                "type": [
                  "number",
                  "string",
                  "null"
                ]
              },
              "status": {
                "type": [
                  "string",
                  "null"
                ],
                "enum": [
                  "delivered",
                  "failed",
                  "no_result",
                  "pending",
                  null
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "claimed_at": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Processing acknowledgement time in Unix seconds; null means unclaimed.",
            "example": null
          }
        }
      },
      "VoteClaimResult": {
        "type": "object",
        "properties": {
          "response": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean",
                "const": true
              }
            },
            "required": [
              "success"
            ]
          }
        },
        "required": [
          "response"
        ]
      }
    },
    "parameters": {
      "ApiVersion": {
        "name": "v",
        "in": "query",
        "required": false,
        "description": "API 版本。不传 v 时使用最低受支持版本。传入 v=1.0.0 可固定文档中的接口契约。无效、重复或不受支持的值返回 HTTP 400。",
        "schema": {
          "type": "string",
          "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
          "const": "1.0.0"
        }
      },
      "created": {
        "name": "created",
        "in": "query",
        "description": "按投票的确切创建时间筛选，单位为 Unix 秒。未指定日期筛选条件时，查询涵盖所有保留的投票。",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "created__gt": {
        "name": "created__gt",
        "in": "query",
        "description": "创建时间，Unix 秒 >",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "created__gte": {
        "name": "created__gte",
        "in": "query",
        "description": "创建时间，Unix 秒 ≥",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "created__lt": {
        "name": "created__lt",
        "in": "query",
        "description": "创建时间，Unix 秒 <",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "created__lte": {
        "name": "created__lte",
        "in": "query",
        "description": "创建时间，Unix 秒 ≤",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "expire": {
        "name": "expire",
        "in": "query",
        "description": "过期时间，Unix 秒",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "expire__gt": {
        "name": "expire__gt",
        "in": "query",
        "description": "过期时间，Unix 秒 >",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "expire__gte": {
        "name": "expire__gte",
        "in": "query",
        "description": "过期时间，Unix 秒 ≥",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "expire__lt": {
        "name": "expire__lt",
        "in": "query",
        "description": "过期时间，Unix 秒 <",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "expire__lte": {
        "name": "expire__lte",
        "in": "query",
        "description": "过期时间，Unix 秒 ≤",
        "schema": {
          "type": "integer",
          "example": 1800000000
        }
      },
      "claimed": {
        "name": "claimed",
        "in": "query",
        "description": "处理状态：0 未处理，1 已处理；默认包含全部",
        "schema": {
          "type": "integer",
          "enum": [
            0,
            1
          ],
          "example": 0
        }
      },
      "limit": {
        "name": "limit",
        "in": "query",
        "description": "条目数量为 1 至 1000，默认为 100",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000,
          "default": 100,
          "example": 100
        }
      },
      "offset": {
        "name": "offset",
        "in": "query",
        "description": "跳过的条目数量，最小为 0，默认为 0",
        "schema": {
          "type": "integer",
          "minimum": 0,
          "default": 0,
          "example": 0
        }
      },
      "order": {
        "name": "order",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "default": "desc",
          "example": "asc"
        }
      },
      "sort": {
        "name": "sort",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "created",
            "expire"
          ],
          "default": "created",
          "example": "created"
        }
      },
      "nickname": {
        "name": "nickname",
        "in": "query",
        "description": "按投票者昵称片段搜索，长度为 3 至 255 个字符",
        "schema": {
          "type": "string",
          "minLength": 3,
          "maxLength": 255,
          "example": "Player"
        }
      },
      "server_id": {
        "name": "server_id",
        "in": "query",
        "schema": {
          "type": "integer",
          "example": 42
        }
      },
      "entity_type": {
        "name": "entity_type",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "server",
            "project"
          ],
          "example": "server"
        }
      },
      "webhook_status": {
        "name": "webhook_status",
        "in": "query",
        "schema": {
          "type": "string",
          "enum": [
            "delivered",
            "failed",
            "no_result",
            "pending"
          ],
          "example": "failed"
        }
      },
      "period": {
        "name": "period",
        "in": "query",
        "description": "按投票创建时间筛选的时间段，默认包含所有保留的历史记录",
        "schema": {
          "type": "string",
          "enum": [
            "24h",
            "7d",
            "30d",
            "90d"
          ],
          "example": "30d"
        }
      }
    },
    "securitySchemes": {
      "AccountAPIKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account API key: 43 base64url characters without a prefix. Claim requires votes:claim scope plus current ownership. Send only in Authorization: Bearer <token>."
      }
    },
    "responses": {
      "BadRequest": {
        "description": "参数或 JSON 无效。请检查类型、必填字段及允许范围。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 400,
                "message": "Invalid request parameters."
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "访问被拒绝：地址被封禁，或项目未公开。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 403,
                "message": "Access denied."
              }
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "服务暂时不可用，请稍后重试。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 503,
                "message": "Service temporarily unavailable."
              }
            }
          }
        }
      },
      "QueryTimeout": {
        "description": "查询超时。请稍后重试或缩小请求范围。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 504,
                "message": "Query timed out."
              }
            }
          }
        }
      },
      "NotFound": {
        "description": "请求的资源不存在。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 404,
                "message": "Resource not found."
              }
            }
          }
        }
      },
      "UnexpectedError": {
        "description": "意外的服务器错误。error 对象包含实际状态码。",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            },
            "example": {
              "error": {
                "code": 500,
                "message": "Internal server error."
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.gamemonitoring.cn"
    }
  ]
}
```
