UapiProUApiPro
游戏

查询 Steam 用户

0次调用
2 积分/次

想在你的网站或应用中展示用户的 Steam 个人资料？这个接口就是为你准备的。

GET
uapis.cn
/api/v1/game/steam/summary
查询参数
4
steamid
string

用户的 Steam 标识。可以是以下任意一种格式：

  • 纯数字的 SteamID64
  • 用户的 自定义 URL 名称 (Vanity URL)
  • 完整的 个人资料链接 (包含 SteamID64 或自定义名称)
  • 好友代码 (如 22202)
id
string

用户的 Steam 自定义URL名称（Vanity URL）。例如个人资料链接中 /id/ 后面的部分。

id3
string

用户的 Steam ID3 格式标识符。传统的 Steam ID 格式，形如 STEAM_X:Y:Z。

key
string

这个接口可以传的访问凭证。此参数选填，如果传入，将优先使用您提供的值。请注意妥善保管，不要把它写进公开的前端代码中。

功能概述

通过一个用户的 Steam 标识（支持多种格式），你可以获取到他公开的个人资料摘要，包括昵称、头像、在线状态、真实姓名（如果公开）和个人资料主页URL等信息。

支持的参数格式

接口现在支持以下几种标识符格式：

  • steamid: 64位SteamID（如 76561197960287930）
  • id: 自定义URL名称（如 gabelogannewell）
  • id3: Steam ID3格式（如 STEAM_0:0:22202）
  • 完整的个人资料链接
  • 好友代码

使用须知

重要

访问凭证说明 这个接口可以传 key 使用您自己的访问凭证。如果您选择传入，请注意妥善保管，不要把它写进公开的前端代码中。

在处理响应时，请注意以下数字代码的含义：

  • personastate (用户状态): 0-离线, 1-在线, 2-忙碌, 3-离开, 4-打盹, 5-想交易, 6-想玩。
  • communityvisibilitystate (社区可见性): 1-私密, 3-公开 (API通常只能查到这两种状态)。

查询参数

steamid
string可选

用户的 Steam 标识。可以是以下任意一种格式：

  • 纯数字的 SteamID64
  • 用户的 自定义 URL 名称 (Vanity URL)
  • 完整的 个人资料链接 (包含 SteamID64 或自定义名称)
  • 好友代码 (如 22202)
id
string可选

用户的 Steam 自定义URL名称（Vanity URL）。例如个人资料链接中 /id/ 后面的部分。

id3
string可选

用户的 Steam ID3 格式标识符。传统的 Steam ID 格式，形如 STEAM_X:Y:Z。

key
string可选

这个接口可以传的访问凭证。此参数选填，如果传入，将优先使用您提供的值。请注意妥善保管，不要把它写进公开的前端代码中。

响应

200 / 请求成功

查询成功！返回用户的 Steam 公开资料摘要。

JSON
{
  // 32x32 像素的小尺寸头像URL。
  "avatar": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb.jpg",
  // 184x184 像素的大尺寸头像URL。
  "avatarfull": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg",
  // 64x64 像素的中等尺寸头像URL。
  "avatarmedium": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_medium.jpg",
  // 社区资料的可见性状态: 1=私密, 3=公开。
  "communityvisibilitystate": 3,
  // 用户个人资料中设置的国家代码 (ISO 3166-1)，前提是用户已设置并公开。
  "loccountrycode": "US",
  // 玩家的当前昵称。
  "personaname": "Gabe Newell",
  // 用户当前的在线状态: 0-离线, 1-在线, 2-忙碌, 3-离开, 4-打盹, 5-想交易, 6-想玩。
  "personastate": 1,
  // 玩家设置的主要部落的64位ID。
  "primaryclanid": "103582791429521412",
  // 如果用户设置了个人资料，则为1。
  "profilestate": 1,
  // 用户的Steam社区个人资料页完整URL。
  "profileurl": "https://steamcommunity.com/id/gabelogannewell/",
  // 用户的真实姓名，前提是用户已设置并公开。
  "realname": "Gabe Logan Newell",
  // 被查询用户的64位SteamID。
  "steamid": "76561197960435530",
  // 账户创建时的Unix时间戳（秒）。
  "timecreated": 1063407589,
  // 我们为你格式化好的账户创建时间，更直观。
  "timecreated_str": "2003-09-12 22:59:49"
}

400 / 错误的请求

请求失败。请检查你是否提供了 steamid、id 或 id3 中的任意一个参数。

JSON
{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing steam identifier parameter. Please provide one of: steamid, id, or id3."
}

401 / 未经授权

认证失败。你提供的 Steam Web API Key 无效或已过期，或者你没有提供 Key。请检查你的 Key。

JSON
{
  "code": "UNAUTHENTICATED",
  "details": {},
  "message": "Missing or invalid API Key."
}

404 / 未找到

用户未找到。根据你提供的 SteamID 未能找到对应的用户，或者该用户资料为完全私密。

JSON
{
  "code": "NOT_FOUND",
  "details": {},
  "message": "User with the specified SteamID not found."
}

502 / 网关错误

暂时无法获取相关游戏数据，请稍后重试。

JSON
{
  "code": "UPSTREAM_ERROR",
  "details": {},
  "message": "Unable to fetch game data. Please try again later."
}
上一篇查询 MC 玩家
下一篇Epic 免费游戏