Documentazione di Steamworks
Interfaccia ISteamUser
Utilizzata per ottenere informazioni e interagire con gli utenti.

Vedi IPlayerService per ulteriori metodi.

Per ulteriori informazioni sull'API web di Steamworks, consulta la seguente documentazione: Panoramica sull'API web.

CheckAppOwnership

GET https://partner.steam-api.com/ISteamUser/CheckAppOwnership/v2/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
steamiduint64ID di Steam dell'utente
appid uint32L'appID per cui verificare la proprietà

Verifica se l'utente specificato possiede l'app.

La risposta JSON conterrà i seguenti campi:

NomeTipoDescrizione
ownsappboolIndica se l'utente è attualmente in possesso dell'app.
permanentboolIndica se l'utente è in possesso definitivo della tua app. Non "true" se ne è in possesso tramite condivisione familiare, weekend gratis o il programma PC Cafe.
timestampstringQuando è stata acquisita l'app.
ownersteamiduint64Indica il vero proprietario se l'utente accede a questa app tramite la condivisione familiare. Altrimenti sarà lo stesso ID di Steam trasmesso.
sitelicenseboolIndica se l'utente sta accedendo a questa app tramite il programma PC Cafe.

Questo metodo ha delle versioni precedenti che non sono più ufficialmente supportate. Potrai continuare a usarle, ma ti consigliamo vivamente di utilizzare la versione più recente.
Cronologia delle modifiche:
  • Versione 2 - aggiunge l'elemento sitelicense alla risposta.

NOTA: per usare questo metodo, la chiamata richiede la chiave dell'API da editore che possiede l'appID specificato. La chiamata API DEVE arrivare da un server protetto e non può mai essere effettuata dai client!

GetAppPriceInfo

GET https://partner.steam-api.com/ISteamUser/GetAppPriceInfo/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
steamiduint64ID di Steam dell'utente
appidsstringLista di appID (100 al massimo), delimitati da virgole

NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API DEVE arrivare da un server protetto e non può mai essere effettuata dai client!

Esempio di risposta:
{ "price_info": { "220": { "packageid": 36, "currency": "USD", "initial_price": 999, "final_price": 999, "discount_percent": 0 } } }

GetDeletedSteamIDs

GET https://partner.steam-api.com/ISteamUser/GetDeletedSteamIDs/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
rowversionuint64Un valore non firmato a 64 bit usato per sfogliare gli account eliminati. Passa 0 quando chiami questa API per la prima volta, poi passa il valore restituito dalla chiamata precedente per ciascuna richiesta aggiuntiva. Questo valore deve essere salvato sul tuo server per chiamate future.

Puoi usare GetDeletedSteamIDs per recuperare una lista degli account eliminati che erano in possesso dei tuoi giochi prima dell'eliminazione. Questa API è stata creata per consentire l'eliminazione di dati in conformità con il regolamento europeo sulla protezione dei dati (GDPR) e per altre finalità di eliminazione delle informazioni personali.

La chiave da editore di Steamworks fornita è usata sia per l'autenticazione che per la generazione della lista di appID da verificare.

GetFriendList

GET https://partner.steam-api.com/ISteamUser/GetFriendList/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'utente per l'API web di Steamworks.
steamiduint64ID di Steam dell'utente
relationshipstringTipo di relazione (ad esempio "amico")

GetPlayerBans

GET https://partner.steam-api.com/ISteamUser/GetPlayerBans/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'utente per l'API web di Steamworks.
steamidsstringElenco delimitato da virgole degli ID di Steam

GetPlayerSummaries

GET https://partner.steam-api.com/ISteamUser/GetPlayerSummaries/v2/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'utente per l'API web di Steamworks.
steamidsstringElenco delimitato da virgole di ID di Steam (100 al massimo)

NOTA: Questa chiamata deve essere utilizzata solo se il tuo sito web deve visualizzare informazioni su un utente. Se il tuo client di gioco necessita di queste informazioni, utilizza invece le API del client.

Questo metodo ha delle versioni precedenti che non sono più ufficialmente supportate. Potrai continuare a usarle, ma ti consigliamo vivamente di utilizzare la versione più recente.
Cronologia delle modifiche:
  • Versione 2 - Rimuove i nomi degli elementi dalle matrici

L'aspetto della risposta alla chiamata sarà simile a questo:

"response":{ "players":[ { "steamid":"77561198355051011", "communityvisibilitystate":1, "profilestate":1, "personaname":"Mister Manager", "lastlogoff":1556305001, "profileurl":"https://steamcommunity.com/profiles/77561198355051011/", "avatar":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/32/32f70a383a437d03af91d2f01a0776adf75201b5.jpg", "avatarmedium":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/32/32f70a383a437d03af91d2f01a0776adf75201b5_medium.jpg", "avatarfull":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/32/32f70a383a437d03af91d2f01a0776adf75201b5_full.jpg", }, { "steamid":"77561197978236369", "communityvisibilitystate":3, "profilestate":1, "personaname":"Olive The Dog", "lastlogoff":1556239336, "profileurl":"https://steamcommunity.com/id/olive_the_dog/", "avatar":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/41/555d2fbb879593c0565ce0489428a09c019feffa.jpg", "avatarmedium":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/41/555d2fbb879593c0565ce0489428a09c019feffa_medium.jpg", "avatarfull":"https://steamcdn-a.akamaihd.net/steamcommunity/public/images/avatars/41/555d2fbb879593c0565ce0489428a09c019feffa_full.jpg", } ] }

GetPublisherAppOwnership

GET https://partner.steam-api.com/ISteamUser/GetPublisherAppOwnership/v3/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
steamiduint64ID di Steam dell'utente


Questo metodo ha delle versioni precedenti che non sono più ufficialmente supportate. Potrai continuare a usarle, ma ti consigliamo vivamente di utilizzare la versione più recente.
Cronologia delle modifiche:
  • Version 3 - Aggiunge l'elemento "sitelicense" alla risposta

L'aspetto della risposta alla chiamata sarà simile a questo:

"appownership":{ "apps":[ { "appid":60, "ownsapp":true, "permanent":true, "timestamp":"2005-04-03T17:50:29Z", "ownersteamid":"76561197978236369", "sitelicense":"false" }, { "appid":220, "ownsapp":false, "permanent":false, "timestamp":"NIL", "ownersteamid":"0", "sitelicense":"true" } ] }

La risposta JSON conterrà i seguenti campi:

NomeTipoDescrizione
appid uint32AppID associato alla tua chiave dell'API web
ownsappboolIndica se l'utente è attualmente in possesso della tua app. "True" se ne è in possesso tramite acquisto, codice prodotto, condivisione familiare, weekend gratis o programma PC Cafe.
permanentboolIndica se l'utente è in possesso definitivo della tua app. Non "true" se ne è in possesso tramite condivisione familiare, weekend gratis o il programma PC Cafe.
timestampstringOrario GMT di quando l'utente ha acquisito l'appID
ownersteamiduint64Indica il vero proprietario se l'utente accede a questa app tramite la condivisione familiare. Altrimenti sarà lo stesso ID di Steam trasmesso.
sitelicenseboolIndica se l'utente sta accedendo a questa app tramite il programma PC Cafe.

NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API DEVE arrivare da un server protetto e non può mai essere effettuata dai client!

GetPublisherAppOwnershipChanges

GET https://partner.steam-api.com/ISteamUser/GetPublisherAppOwnershipChanges/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
packagerowversionstringLa versione di riga senza firma a 64 bit da cui leggere le modifiche al pacchetto. La versione di riga dei dati letti verrà restituita per essere utilizzata nelle chiamate future.
cdkeyrowversionstringLa versione di riga senza firma a 64 bit da cui leggere le modifiche al codice prodotto. La versione di riga dei dati letti verrà restituita per essere utilizzata nelle chiamate future.

Questo metodo può essere usato per determinare quali ID di Steam hanno modifiche alle proprietà, partendo da un numero specifico della versione di riga di una chiave o di un prodotto. Dalla lista di ID di Steam restituiti, una chiamata a GetPublisherAppOwnership può, a sua volta, restituire i dati di proprietà associati per le applicazioni nel gruppo associato al codice immesso. Un partner potrebbe volere tenere traccia di questi dati insieme agli account di Steam collegati per comprendere meglio lo stato della proprietà del prodotto su Steam.

Per iniziare, effettua una chiamata a GetPublisherAppOwnershipChangespassando packagerowversion e cdkeyrowversion con i valori di 0 (zero). L'aspetto della risposta alla chiamata sarà simile a questo:

"ownershipchanges": { "steamids": [ { "steamid": "76561198114498811" }, { "steamid": "76561198114498812" }, ... ], "packagerowversion": "12448390228", "cdkeyrowversion": "49857241147", "moredata": true }

La risposta JSON conterrà i seguenti campi:

NomeTipoDescrizione
steamids/steamidstringL'elenco di ID di Steam per tutti gli account che sono stati modificati rispetto alle versioni di riga fornite. Saranno restituiti fino a 10.000 ID di Steam per chiamata.
packagerowversionstringLa versione di riga del pacchetto che coincide con l'ultimo ID di Steam restituito. Salvala per chiamate future a GetPublisherAppOwnershipChanges
cdkeyrowversionstringLa versione di riga del codice prodotto che coincide con l'ultimo ID di Steam restituito. Salvala per chiamate future a GetPublisherAppOwnershipChanges
moredataboolIndica se sono disponibili più dati e più recenti.

Dopo questa prima chiamata restituisce:
  1. Effettua una chiamata a GetPublisherAppOwnership per ogni ID di Steam per ottenere la proprietà effettiva di ciascun appID. Archivia o utilizza questi dati a seconda delle tue necessità.
  2. Una volta che gli ID di Steam vengono processati, verifica il valore di moredata. Se "true", effettua una nuova chiamata a GetPublisherAppOwnershipChanges, passando packagerowversion e cdkeyrowversion come restituiti dalla chiamata precedente a GetPublisherAppOwnershipChanges.
  3. Ripeti i passaggi 1 e 2 finchè moredata non restituisce "false".
  4. Archivia i valori finali di packagerowversion and cdkeyrowversion per utilizzarli nelle future chiamate GetPublisherAppOwnershipChanges (ad esempio 24 ore dopo), invece che ricominciare di nuovo da 0 (zero).

NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API DEVE arrivare da un server protetto e non può mai essere effettuata dai client!

GetUserGroupList

GET https://partner.steam-api.com/ISteamUser/GetUserGroupList/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'editore per l'API web di Steamworks.
steamiduint64ID di Steam dell'utente

ResolveVanityURL

GET https://partner.steam-api.com/ISteamUser/ResolveVanityURL/v1/
NomeTipoNecessarioDescrizione
keystringChiave di autenticazione dell'utente per l'API web di Steamworks.
vanityurlstringIl vanity URL per cui ottenere un ID di Steam
url_typeint32Il tipo di vanity URL. 1 (predefinito): Profilo individuale. 2: Gruppo. 3: Gruppo ufficiale del gioco