Steamworks ドキュメンテーション
ISteamLeaderboardsインターフェイス
Steamランキングへのアクセスに使用されます。

SteamworksのWeb APIの使用に関する詳細は、Web API 概要 を参照してください。

DeleteLeaderboard

POST https://partner.steam-api.com/ISteamLeaderboards/DeleteLeaderboard/v1/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID
namestring削除するランキングの名前



注: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは 必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!

FindOrCreateLeaderboard

POST https://partner.steam-api.com/ISteamLeaderboards/FindOrCreateLeaderboard/v2/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID
namestring作成するランキングの名前
sortmethodstringこのランキングに使用する並べ替え方法(デフォルトは昇順)
displaytypestringこのランキングの表示方法(デフォルトは数値)
createifnotfoundboolこれがtrueで、ランキングが存在しない場合は作成されます。 デフォルトはtrueです。
onlytrustedwritesboolこれがtrueの場合、ランキングスコアはクライアントによって設定できなくなり、SetLeaderboardScore WebAPI経由でパブリッシャーによってのみに設定可能になります。 デフォルトは falseです。
onlyfriendsreadsboolこれがtrueの場合、ランキングスコアはクライアントによってフレンド用にのみ読み込まれます。スコアはパブリッシャーによって常に読み込まれます。 デフォルトはfalseです。



このメソッドには、現在公式にはサポートされていない古いバージョンが存在します。 今後も引き続き使用可能ですが、最新バージョンの使用を強く推奨します。
変更履歴:
  • バージョン2-ランキング名をXMLで返すよう修正。

注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!

GetLeaderboardEntries

GET https://partner.steam-api.com/ISteamLeaderboards/GetLeaderboardEntries/v1/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID
rangestartint32範囲開始または0
rangeendint32範囲終了または最大ランキングエントリー
steamiduint64フレンドとユーザーリクエスト周辺で使用されるSteamID
leaderboardidint32表示するランキングのID
datarequestuint32リクエストの種類:RequestGlobal、RequestAroundUser、RequestFriends



注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!

GetLeaderboardsForGame

GET https://partner.steam-api.com/ISteamLeaderboards/GetLeaderboardsForGame/v2/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID



このメソッドには、現在公式にはサポートされていない古いバージョンが存在します。 今後も引き続き使用可能ですが、最新バージョンの使用を強く推奨します。
変更履歴:
  • バージョン2-ランキング名をXMLで返すよう修正。

注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!

ResetLeaderboard

POST https://partner.steam-api.com/ISteamLeaderboards/ResetLeaderboard/v1/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID
leaderboardiduint32対象ランキングの数値ID。 GetLeaderboardsForGameから取得可能



注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!

SetLeaderboardScore

POST https://partner.steam-api.com/ISteamLeaderboards/SetLeaderboardScore/v1/
名前必須説明
keystringSteamworks Web APIパブリッシャー認証キー
appiduint32ゲームのAppID
leaderboardiduint32対象ランキングの数値ID。 GetLeaderboardsForGameから取得可能
steamiduint64スコアを設定するsteamID
scoreint32このユーザー用に設定するスコア
scoremethodstring使用するアップデート方法 "KeepBest" または "ForceUpdate"
detailsrawbinaryゲーム特定のスコア獲得方法の詳細。 最大256バイト。



注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!