Used to access information and interact with users.

See IPlayerService for additional methods.

For more info on how to use the Steamworks Web API please see the Обзор на уеб приложно програмния интерфейс.

CheckAppOwnership

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
steamid	uint64	✔	Steam № на потребител.
appid	uint32	✔	AppID to check for ownership

Checks if the specified user owns the app.

The JSON response will contain the following fields:

Име	Тип	Описание
ownsapp	bool	Indicates if the user is the actual owner or the app.
permanent	bool	Дали потребителят постоянно притежава приложението Ви. Не важи за притежание чрез „Семейно споделяне“, „Безплатен уикенд“ или програмата за компютърни зали.
timestamp	string	Time that the app was acquired.
ownersteamid	uint64	Посочва действителния притежател, ако потребителят има достъп до това приложение чрез „Семейно споделяне“. В противен случай ще бъде същият предоставен Steam №.
sitelicense	bool	Посочва дали потребителят има достъп до това приложение чрез програмата за компютърни зали.

Този метод разполага с предходни версии, които вече не се поддържат официално. They will continue to be usable but it's highly recommended that you use the latest version.
Change history:

• Version 2 - Adds element sitelicense to the response.

ЗАБЕЛЕЖКА: This call requires the publisher API key that owns the specified App ID to use this method. As such this API MUST be called from a secure server, and can never be used directly by clients!

GetAppPriceInfo

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
steamid	uint64	✔	Steam № на потребител.
appids	string	✔	Comma-delimited list of appids (max: 100)

ЗАБЕЛЕЖКА: This call requires a publisher API key to use this method. As such this API MUST be called from a secure server, and can never be used directly by clients!

Примерен отклик:

GetDeletedSteamIDs

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
rowversion	uint64	✔	An unsigned 64-bit value used to page through deleted accounts. Pass 0 when calling this API for the first time, then pass the value returned from the previous call for each additional request. This value will need to be stored on your server for future calls.

You can use GetDeletedSteamIDs to retrieve a list of deleted accounts that owned your game(s) before deletion. This API was created to allow for the deletion of user related data for GDPR and other personal information related purposes.

The provided Steamworks Publisher Key is used for both authentication and to generate the list of appids to check against.

GetFriendList

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API user authentication key.
steamid	uint64	✔	Steam № на потребител.
relationship	string		Тип взаимоотношение (напр. приятел).

GetPlayerBans

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API user authentication key.
steamids	string	✔	Comma-delimited list of SteamIDs

GetPlayerSummaries

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API user authentication key.
steamids	string	✔	Comma-delimited list of SteamIDs (max: 100)

ЗАБЕЛЕЖКА: This call should only be used if your website needs to display information about a user. If your game client needs any of this information, please use the client APIs instead.

This method has previous versions which are no longer officially supported. They will continue to be usable but it's highly recommended that you use the latest version.
Change history:

• Version 2 - Removes element names from arrays

The response from the call will look something like this:

GetPublisherAppOwnership

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
steamid	uint64	✔	Steam № на потребител.

This method has previous versions which are no longer officially supported. They will continue to be usable but it's highly recommended that you use the latest version.
Change history:

• Version 3 - Adds element sitelicense to the response

The response from the call will look something like this:


The JSON response will contain the following fields:

Име	Тип	Описание
appid	uint32	AppID associated with your WebAPI key
ownsapp	bool	Дали потребителят понастоящем притежава приложението Ви. Ще важи за притежание чрез покупки, CD ключове, „Семейно споделяне“, „Безплатен уикенд“ или програмата за компютърни зали.
permanent	bool	Дали потребителят постоянно притежава приложението Ви. Не важи за притежание чрез „Семейно споделяне“, „Безплатен уикенд“ или програмата за компютърни зали.
timestamp	string	GMT time for when the user first accquired the appID
ownersteamid	uint64	Посочва действителния притежател, ако потребителят има достъп до това приложение чрез „Семейно споделяне“. В противен случай ще бъде същият предоставен Steam №.
sitelicense	bool	Посочва дали потребителят има достъп до това приложение чрез програмата за компютърни зали

ЗАБЕЛЕЖКА: Това повикване изисква API ключа на издателя, за да се използва този метод. As such this API MUST be called from a secure server, and can never be used directly by clients!

GetPublisherAppOwnershipChanges

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
packagerowversion	string	✔	The unsigned 64-bit row version to read package changes from. The row version of data read up to will be returned for use in future calls.
cdkeyrowversion	string	✔	The unsigned 64-bit row version to read CD Key changes from. The row version of data read up to will be returned for use in future calls.

This method can be used to determine what SteamIDs have ownership changes starting from a particular package or key row version number. From the list of SteamIDs returned, a call to GetPublisherAppOwnership can then return the associated ownership data for the applications in the group associated with the key passed in. A partner may wish to track this data in conjunction with linked Steam Accounts to better understand the state of product ownership on Steam.

To begin, make a call to GetPublisherAppOwnershipChanges passing in packagerowversion and cdkeyrowversion with the values of 0 (zero). The response from the call will look something like this:


The JSON response will contain the following fields:

Име	Тип	Описание
steamids/steamid	string	The list of SteamIDs for any accounts that have changed since the provided row versions. Up to 10,000 SteamIDs will be returned per call.
packagerowversion	string	The package row version that matches the last SteamID returned. Store this for future calls to GetPublisherAppOwnershipChanges
cdkeyrowversion	string	The cd key row version that matches the last SteamID returned. Store this for future calls to GetPublisherAppOwnershipChanges
moredata	bool	Indicates if more and newer data is available.

After this first call returns:

1. Make a call to GetPublisherAppOwnership for each SteamID to get the actual ownership per AppID. Store or use that data as needed.
   
2. Once all the SteamIDs have been processed, check the value of moredata. If it is true, make a new call to GetPublisherAppOwnershipChanges passing in the packagerowversion and cdkeyrowversion as returned from the previous call to GetPublisherAppOwnershipChanges.
   
3. Repeat Step 1 and 2 until moredata returns false.
   
4. Store the final packagerowversion and cdkeyrowversion values for use in future GetPublisherAppOwnershipChanges calls (e.g. 24 hours later) instead of starting at 0 (zero) again.

ЗАБЕЛЕЖКА: This call requires a publisher API key to use this method. As such this API MUST be called from a secure server, and can never be used directly by clients!

GetUserGroupList

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API publisher authentication key.
steamid	uint64	✔	Steam № на потребител.

ResolveVanityURL

Име	Тип	Изисквано	Описание
key	string	✔	Steamworks Web API user authentication key.
vanityurl	string	✔	The vanity URL to get a SteamID for
url_type	int32		Типът на суетния адрес. 1 (default): Individual profile, 2: Group, 3: Official game group