用于访问关于用户的信息。
请参见
Web API 概览,了解更多有关使用 Steamworks Web API 的信息。
GetGlobalAchievementPercentagesForApp
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
| 名称 | 类型 | 是否必需 | 描述 |
| gameid | uint64 | ✔ | 要获取成就百分比的 GameID。 |
为指定应用获取全局成就百分比。
此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
GetGlobalStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 发行商验证密钥。 |
| appid | uint32 | ✔ | 要获取全局统计的 AppID。 |
| count | uint32 | ✔ | 要为其获取数据的统计项目的数量。 |
| name[0] | string | ✔ | 要为其获取数据的统计项目的名称。 |
| startdate | uint32 | | 每日总数的开始日期(unix 时间戳) |
| enddate | uint32 | | 每日总数的结束日期(unix 时间戳) |
为指定应用获取全局统计数据百分比。
参见
全局统计文档,了解更多信息。
GetNumberOfCurrentPlayers
GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| appid | uint32 | ✔ | 要为其获取用户数量的 AppID。 |
获得指定应用当前在 Steam 上的活跃玩家的总数量。
注意,这不会返回正在玩游戏但未连接至 Steam 的玩家。
GetPlayerAchievements
GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 用户验证密钥。 |
| steamid | uint64 | ✔ | 用户的 SteamID。 |
| appid | uint32 | ✔ | 要为其获取成就的 AppID。 |
| l | string | | 返回字符串的语言。 |
获得指定用户在一个应用中已解锁成就的列表。
GetSchemaForGame
GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 用户验证密钥。 |
| appid | uint32 | ✔ | 游戏的 appid。 |
| l | string | | 要返回的本地化语言(english、french 等)。 |
获得指定游戏的统计数据与成就的完整列表。
此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
- 第 2 版 - 修复了以 XML 格式返回游戏名称的问题。
GetUserStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 用户验证密钥。 |
| steamid | uint64 | ✔ | 用户的 SteamID。 |
| appid | uint32 | ✔ | 游戏的 appid。 |
获得指定用户在一个应用中设置的统计数据的列表。
此方法有官方不再支持的旧版。 旧版可以继续使用,但我们强烈建议您使用最新版本。
变更历史:
- 第 2 版 - 修复了以 XML 格式返回游戏名称的问题。
SetUserStatsForGame
POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 发行商验证密钥。 |
| steamid | uint64 | ✔ | 用户的 SteamID。 |
| appid | uint32 | ✔ | 游戏的 appid。 |
| count | uint32 | ✔ | 要为其设置值的统计与成就的数量(名称/值参数对)。 |
| name[0] | string | ✔ | 要设置的统计与成就的名称。 |
| value[0] | uint32 | ✔ | 要设置的值。 |
为游戏设置指定用户的统计数据。
注意: 此调用要求拥有指定 App ID 的发行商 API 密钥才能使用此方法。 因此,此 API
必须通过安全服务器调用,且绝不能由客户端直接调用!