Proporciona acceso a servicios relacionados con el funcionamiento de locales que forman parte del programa de licencia para locales de Steam.
GetCurrentClientConnections
GET https://api.steampowered.com/ISiteLicenseService/GetCurrentClientConnections/v1/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
siteid | uint64 | | Id. del local que se desea ver; 0 para verlos todos. |
Sirve para ver la actividad actual en uno o más locales.
La respuesta tiene la siguiente estructura:
Nombre | Tipo | Descripción |
sites | ver más abajo | Una lista de detalles del local. |
game_names | ver más abajo | Lista mapeada de los nombres de los juegos. |
game_names
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
id | uint32 | Número de id. de la entrada, al que se hace referencia en la información de local de abajo. |
name | string | Nombre del juego. |
sites
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
siteid | uint64 | Id. de 64 bits del local. |
site_name | string | Nombre que has asignado al local. |
clients | ver más abajo | Lista de clientes activos en el local. |
clients
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
ip_address | string | Dirección IP del equipo cliente. |
hostname | string | Nombre del equipo cliente. |
games | ver más abajo | Lista de sesiones de juego activas en el equipo cliente. |
games
tiene la siguiente estructura:
Name | Tipo | Descripción |
id | uint32 | Id. del juego en la sección game_names de la respuesta. |
start_time | string | Hora de inicio de esta sesión de juego (formato RFC 3339 UTC). |
license_type | string | ver más abajo |
license_type
puede tener uno de los siguientes valores:
Valor | Descripción |
user | El usuario posee una licencia para el juego. |
commercial | El usuario está jugando a través de una licencia comercial de pago aplicada al local. |
free | El usuario está jugando a través de una licencia comercial gratuita aplicada al local. |
GetTotalPlaytime
GET https://api.steampowered.com/ISiteLicenseService/GetTotalPlaytime/v1/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
start_time | string | ✔ | Informa de la actividad iniciada a esta hora o después (formato RFC 3339 UTC). |
end_time | string | ✔ | Informa de la actividad iniciada antes de esta hora (formato RFC 3339 UTC). |
siteid | uint64 | | Id. del local que se desea ver; 0 para verlos todos. |
Obtiene los tiempos de juego totales de todos los juegos durante un período de tiempo, para uno o todos los locales.
La respuesta tiene la siguiente estructura:
Nombre | Tipo | Descripción |
sites | ver más abajo | Una lista de detalles del local. |
game_names | ver más abajo | Lista mapeada de los nombres de los juegos. |
game_names
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
id | uint32 | Número de id. de la entrada, al que se hace referencia en la información de local de abajo. |
name | string | Nombre del juego. |
sites
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
siteid | uint64 | Id. de 64 bits del local. |
site_name | string | Nombre que has asignado al local. |
games | ver más abajo | Lista de todos los títulos jugados. |
games
tiene la siguiente estructura:
Nombre | Tipo | Descripción |
id | uint32 | Id. del juego en la sección game_names de la respuesta. |
license_type | string | El tiempo de juego se divide para cada juego por el tipo de licencia utilizada. Consulta la sección GetCurrentClientConnections de arriba para ver la lista de tipos. |
playtime_seconds | uint32 | Tiempo de juego total para este juego y tipo de licencia, en segundos, para el período solicitado. |