提供权限,以访问与参与 Steam 网吧计划的运营站点相关的服务。
GetCurrentClientConnections
GET https://api.steampowered.com/ISiteLicenseService/GetCurrentClientConnections/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 发行商验证密钥。 |
| siteid | uint64 | | 要看到的站点 ID;零为所有站点。 |
查看一个或多个站点的当前活动。
响应具有以下结构:
| 名称 | 类型 | 描述 |
| sites | 见下方 | 站点详情列表 |
| game_names | 见下方 | 游戏名称的映射列表。 |
game_names 具有以下结构:
| 名称 | 类型 | 描述 |
| id | uint32 | 条目的 ID 号;在下方的站点信息中引用 |
| name | string | 游戏名称 |
sites 具有以下结构:
| 名称 | 类型 | 描述 |
| siteid | uint64 | 站点的 64 位 SiteID |
| site_name | string | 您为站点分配的站点名称 |
| clients | 见下方 | 站点活跃客户端列表 |
clients 具有以下结构:
| 名称 | 类型 | 说明 |
| ip_address | string | 客户端电脑的 IP 地址 |
| hostname | string | 客户端电脑的机器名称 |
| games | 见下方 | 客户端电脑上的活跃游戏会话列表 |
games 具有以下结构:
| 名称 | 类型 | 描述 |
| id | uint32 | 响应中 game_names 部分的游戏 ID |
| start_time | string | 此游戏会话开始的时间(RFC 3339 UTC 格式) |
| license_type | string | 见下方 |
license_type 可能具有以下的值之一:
| 值 | 描述 |
| user | 用户拥有游戏许可 |
| commercial | 用户正在通过应用至该站点的付费商用许可进行游戏 |
| free | 用户正在通过应用至该站点的免费商用许可进行游戏 |
GetTotalPlaytime
GET https://api.steampowered.com/ISiteLicenseService/GetTotalPlaytime/v1/
| 名称 | 类型 | 是否必需 | 描述 |
| key | string | ✔ | Steamworks Web API 发行商验证密钥。 |
| start_time | string | ✔ | 报告此时或之后开始的活动。 RFC 3339 UTC 格式。 |
| end_time | string | ✔ | 报告此时之前开始的活动。 RFC 3339 UTC 格式。 |
| siteid | uint64 | | 要看到的站点 ID;零为所有站点。 |
获取一段时间内所有游戏的总游玩时间,可以针对一个或全部站点。
响应具有以下结构:
| 名称 | 类型 | 描述 |
| sites | 见下方 | 站点详情列表 |
| game_names | 见下方 | 游戏名称的映射列表。 |
game_names 具有以下结构:
| 名称 | 类型 | 描述 |
| id | uint32 | 条目的 ID 号;在下方的站点信息中引用 |
| name | string | 游戏名称 |
sites 具有以下结构:
| 名称 | 类型 | 描述 |
| siteid | uint64 | 站点的 64 位 SiteID |
| site_name | string | 您为站点分配的站点名称 |
| games | 见下方 | 玩过的所有游戏的名称 |
games 具有以下结构:
| 名称 | 类型 | 描述 |
| id | uint32 | 响应中 game_names 部分的游戏 ID |
| license_type | string | 根据许可类型将一款游戏的游戏时间进行划分。 请参阅上方的 GetCurrentClientConnections 一节,查看列表。 |
| playtime_seconds | uint32 | 此游戏的此种许可类型在请求期间内的总游戏时间(以秒为单位)。 |