Documentación de Steamworks
Interfaz ISteamUserStats
Se utiliza para acceder a información acerca de los usuarios.

Para obtener más información sobre cómo utilizar la Web de API de Steamworks, consulta el artículo Descripción general de la Web de API.

GetGlobalAchievementPercentagesForApp

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
NombreTipoObligatorioDescripción
gameiduint64Id. del juego para el que recuperar los porcentajes de logros.

Recupera los porcentajes de logros globales de la aplicación especificada.

Este método tiene versiones anteriores que ya no son compatibles oficialmente. Seguirán siendo utilizables, pero se recomienda encarecidamente que utilices la última versión.
Historial de cambios:
  • Versión 2: elimina los nombres de los elementos de las matrices.

GetGlobalStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
NombreTipoObligatorioDescripción
appiduint32Id. de aplicación de la que obtenemos las estadísticas globales.
countuint32Número de estadísticas para las que se obtienen los datos.
name[0]stringNombres de estadística para la que se obtienen los datos.
startdateuint32Fecha final de totales diarios (tiempo Unix).
enddateuint32Fecha final de totales diarios (tiempo Unix).

Recupera los porcentajes de las estadísticas globales de la aplicación especificada.

Consulta la documentación Estadísticas globales] para más información.

GetNumberOfCurrentPlayers

GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
NombreTipoObligatorioDescripción
appiduint32Id. de aplicación de la que obtenemos el recuento de usuarios.

Obtiene el número total de jugadores que se encuentran activos en la aplicación de Steam especificada.

Ten en cuenta que no devolverá jugadores que jueguen sin estar conectados a Steam.

GetPlayerAchievements

GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de usuario de la Web de API de Steamworks.
steamiduint64Id. de Steam del usuario.
appiduint32Id. de la aplicación para obtener los logros.
lstringIdioma en el que se puede devolver las cadenas.

Obtiene la lista de logros que el usuario especificado ha desbloqueado en una aplicación.

GetSchemaForGame

GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
NombreTipoObligatorioDescripción
keystringClave de autenticación de usuario de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
lstringIdioma localizado a devolver (inglés, francés, etc.).

Obtiene la lista completa de estadísticas y logros del juego especificado.

Este método tiene versiones anteriores que ya no son compatibles oficialmente. Seguirán siendo utilizables, pero se recomienda encarecidamente que uses la última versión.
Historial de cambios:
  • Versión 2: corrige la devolución del nombre del juego en XML.

GetUserStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
NameTipoObligatorioDescripción
keystringClave de autenticación de usuario de la Web de API de Steamworks.
steamiduint64Id. de Steam del usuario.
appiduint32Id. de aplicación del juego.

Obtiene la lista de estadísticas que el usuario especificado ha establecido en una aplicación.

Este método tiene versiones anteriores que ya no son compatibles oficialmente. Seguirán siendo utilizables, pero se recomienda encarecidamente que uses la última versión.
Historial de cambios:
  • Versión 2: corrige la devolución del nombre del juego en XML.

SetUserStatsForGame

POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
steamiduint64Id. de Steam del usuario.
appiduint32Id. de aplicación del juego.
countuint32Número de estadísticas y logros para los que debes establecer un valor (pares de parámetros nombre-valor).
name[0]stringNombre de la estadística o el logro que ha de establecerse.
value[0]uint32Valor a establecer

Establece una estadística del juego para el usuario especificado.

NOTA: Para utilizar este método, esta llamada requiere la clave de API de editor propietaria del id. de aplicación especificado. Por tanto, esta API DEBE llamarse desde un servidor seguro, ¡y los clientes jamás pueden usarla directamente!