Documentation Steamworks
Interface ISteamUserStats
Donne accès aux informations relatives aux utilisateurs et utilisatrices.

Pour plus d'informations sur l'utilisation de l'API web de Steamworks, consultez la section Présentation de l'API Web.

GetGlobalAchievementPercentagesForApp

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
NomTypeRequisDescription
gameiduint64AppID pour lequel récupérer les pourcentages de succès.

Récupère les pourcentages des succès généraux pour l'application spécifiée.

Cette méthode dispose de versions plus anciennes qui ne sont plus prises en charge. Ces versions sont toujours utilisables, mais il est fortement recommandé d'utiliser la dernière en date.
Historique des modifications :
  • Version 2 : supprime les noms des éléments des tableaux.

GetGlobalStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
NomTypeRequisDescription
appid uint32AppID pour lequel toutes les statistiques sont recherchées.
countuint32Nombre de statistiques pour lesquelles obtenir des données.
name[0]stringNoms des statistiques pour lesquelles obtenir des données.
startdateuint32Date de début pour les totaux quotidiens (horodatage au format de l'heure Unix).
enddateuint32Date de fin pour les totaux quotidiens (horodatage au format de l'heure Unix).

Récupère les pourcentages des statistiques globales pour l'application spécifiée.

Pour plus d'informations, consultez Statistiques globales dans la documentation.

GetNumberOfCurrentPlayers

GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
NomTypeRequisDescription
appiduint32AppID pour lequel le nombre d'utilisateurs et d'utilisatrices est recherché.

Permet d'obtenir le nombre total de joueurs et de joueuses actuellement actifs dans l'application spécifiée sur Steam.

Veuillez noter que ce paramètre ne renverra pas les joueurs et joueuses actifs n'étant pas connectés sur Steam.

GetPlayerAchievements

GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
NomTypeRequisDescription
keystringClé d'authentification du compte pour l'API web de Steamworks.
steamiduint64SteamID de la personne.
appiduint32AppID pour lequel obtenir les succès.
lstringLangue pour laquelle renvoyer les chaines.

Permet d'obtenir une liste des succès que la personne spécifiée a déverrouillé dans une application.

GetSchemaForGame

GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
NomTypeRequisDescription
keystringClé d'authentification du compte pour l'API web de Steamworks.
appiduint32AppID du jeu.
lstringLangue de localisation à renvoyer (« english », « french », etc.)

Permet d'obtenir la liste complète des statistiques et succès pour le jeu renseigné.

Cette méthode dispose de versions plus anciennes qui ne sont plus prises en charge. Ces versions sont toujours utilisables, mais il est fortement recommandé d'utiliser la dernière en date.
Historique des modifications :
  • Version 2 : corrige le renvoi du nom du jeu en XML.

GetUserStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
NomTypeRequisDescription
keystringClé d'authentification du compte pour l'API web de Steamworks.
steamiduint64SteamID de la personne.
appiduint32AppID du jeu.

Permet d'obtenir la liste de statistiques définie par la personne spécifiée dans une application.

Cette méthode dispose de versions plus anciennes qui ne sont plus prises en charge. Ces versions sont toujours utilisables, mais il est fortement recommandé d'utiliser la dernière en date.
Historique des modifications :
  • Version 2 : corrige le renvoi du nom du jeu en XML.

SetUserStatsForGame

POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
NomTypeRequisDescription
keystringClé d'authentification de l'équipe d'édition pour l'API web de Steamworks.
steamiduint64SteamID de la personne.
appiduint32AppID du jeu.
countuint32Nombre de statistiques et de succès pour lesquels définir une valeur (paires de paramètres nom/valeur)
name[0]stringNom de la statistique ou du succès à définir
value[0]uint32Valeur à définir

Définit une statistique pour la personne spécifiée pour le jeu.

REMARQUE : afin d'utiliser cette méthode, cet appel nécessite la clé d'API d'édition possédant l'AppID spécifié. Il est donc OBLIGATOIRE que cette API soit appelée depuis un serveur sécurisé. Elle ne doit jamais être utilisée directement par la clientèle !