Steamworks 文獻庫
GetHistoryCommandDetails/v0001
傳回使用者在指定期間內所有的稽核紀錄。 傳回的為 starttime 之後至 endtime 或之前的任何事件。

呼叫方: 客服工具

HTTP 方法: GET
這將傳回此指令收到確認後資產伺服器將執行的詳細動作列表。 若為複雜動作,客服人員可選擇啟用或停用部分的交易指令。 客服人員確認完詳細資料後,即會呼叫 HistoryExecuteCommand/v0001

參數:

名稱型別必要說明
keystring此為在夥伴網站上,您在您應用程式的 Steam 經濟設定中提供的「資產伺服器金鑰」。
appiduint32與資產關聯之應用程式的 32 位元 App ID。
steamiduint64為其傳回資產的使用者的 64 位元 Steam ID。
contextiduint64資產所在脈絡的 64 位元 ID。
commandstring歷史指令的名稱。
argumentsuint32GetUserHistory 為此指令傳回的引數字串。

傳回

此方法的輸出應以 JSON 格式編碼。

回應:
  • result
    • success - 若方法成功,則為 True。 如果資產伺服器傳回 False,則會將 error 設為說明其原因的字串。
    • error - 說明呼叫失敗原因的字串。 此訊息將儲存於錯誤紀錄中。錯誤紀錄位於 Steamworks 網站中的「經濟」分頁之下。
    • actions - 客服人員確認指令後,資產伺服器將執行的動作陣列。
      • id - 將受到此動作影響的資產 ID。
      • icon_url(可選用)- 用於此資產的圖示。 圖片應為 JPEG、GIF,或 PNG 格式,大小應至少為 96 x 96 像素。 PNG 與 GIF 支援透明度,因此較推薦使用。
      • name - 受影響的資產名稱。
      • command - 執行於此資產上的子指令。 此值會於確認階段傳回。
      • note(可選用)- 在確認對話方塊中顯示於名稱下方的額外資訊。
      • argument(可選用)- 此動作在確認階段時仍被選取的話傳回的引數字串。
      • steamid(可選用)- 目前擁有此資產的使用者的 64 位元 Steam ID。 使用者的名稱將顯示於資產名稱旁邊。
      • optional(可選用)- 若為 True,客服人員可解除勾選,並在指令中跳過此動作, 預設為 True。
      • default(可選用)- 核選方塊在確認對話方塊中的預設狀態, 預設為 True。

輸出範例

{ "result":1, "actions": [ { "id":"2111437", "icon_url":"http://media.steampowered.com/apps/440/icons/berliners_bucket_helm.2c1288625a8ab4c16e3c804a6649254b1a9325ca.png", "name":"Berliner's Bucket Helm", "command":"Restore", "note":"Purchased" }, { "id":"2121062", "icon_url":"http://media.steampowered.com/apps/440/icons/gift_fashion.37487e85b245787048aacefe67105bbe44a20e0c.png", "name":"Manniversary Package", "command":"Delete", "note":"Timed Drop" }, ], "displaytext":"" }