Used to access Steam leaderboards.
For more info on how to use the Steamworks Web API please see the
Обзор на уеб приложно програмния интерфейс.
DeleteLeaderboard
POST https://partner.steam-api.com/ISteamLeaderboards/DeleteLeaderboard/v1/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
| name | string | ✔ | name of the leaderboard to delete |
ЗАБЕЛЕЖКА: 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!
FindOrCreateLeaderboard
POST https://partner.steam-api.com/ISteamLeaderboards/FindOrCreateLeaderboard/v2/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
| name | string | ✔ | name of the leaderboard to create |
| sortmethod | string | | sort method to use for this leaderboard (defaults to Ascending) |
| displaytype | string | | display type for this leaderboard (defaults to Numeric) |
| createifnotfound | bool | | if this is true the leaderboard will be created if it doesn't exist. Defaults to true. |
| onlytrustedwrites | bool | | if this is true the leaderboard scores cannot be set by clients, and can only be set by publisher via SetLeaderboardScore WebAPI. По подразбиране е „false“; |
| onlyfriendsreads | bool | | if this is true the leaderboard scores can only be read for friends by clients, scores can always be read by publisher. По подразбиране е „false“. |
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 - Fixes returning the leaderboard name in XML.
ЗАБЕЛЕЖКА: 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!
GetLeaderboardEntries
GET https://partner.steam-api.com/ISteamLeaderboards/GetLeaderboardEntries/v1/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
| rangestart | int32 | ✔ | range start or 0 |
| rangeend | int32 | ✔ | range end or max LB entries |
| steamid | uint64 | | SteamID used for friend & around user requests |
| leaderboardid | int32 | ✔ | ID of the leaderboard to view |
| datarequest | uint32 | ✔ | type of request: RequestGlobal, RequestAroundUser, RequestFriends |
ЗАБЕЛЕЖКА: 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!
GetLeaderboardsForGame
GET https://partner.steam-api.com/ISteamLeaderboards/GetLeaderboardsForGame/v2/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
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 - Fixes returning the leaderboard name in XML.
ЗАБЕЛЕЖКА: 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!
ResetLeaderboard
POST https://partner.steam-api.com/ISteamLeaderboards/ResetLeaderboard/v1/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
| leaderboardid | uint32 | ✔ | numeric ID of the target leaderboard. Can be retrieved from GetLeaderboardsForGame |
ЗАБЕЛЕЖКА: 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!
SetLeaderboardScore
POST https://partner.steam-api.com/ISteamLeaderboards/SetLeaderboardScore/v1/
| Име | Тип | Изисквано | Описание |
|---|
| key | string | ✔ | Steamworks Web API publisher authentication key. |
| appid | uint32 | ✔ | № на приложение за игра. |
| leaderboardid | uint32 | ✔ | numeric ID of the target leaderboard. Can be retrieved from GetLeaderboardsForGame |
| steamid | uint64 | ✔ | Steam №, за който да се зададе резултатът. |
| score | int32 | ✔ | Резултатът, който да се зададе за този потребител. |
| scoremethod | string | ✔ | update method to use. Can be "KeepBest" or "ForceUpdate" |
| details | rawbinary | | game-specific details for how the score was earned. Up to 256 bytes. |
ЗАБЕЛЕЖКА: 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!
