Dokumentacja Steamworks
GetHistoryCommandDetails/v0001
Zwraca wszystkie wpisy działań kontrolnych dla użytkownika w określonym przedziale czasu. Zwracany przedział czasu jest dowolnym zdarzeniem po starttime, ale przed lub w momencie endtime.

Wywoływana przez: narzędzie pomocy technicznej

Metoda HTTP: GET
Zwraca szczegółową listę działań, które serwer zasobów wykona, jeśli to polecenie zostanie potwierdzone. W przypadku złożonych działań pracownik pomocy technicznej może wyłączyć lub włączyć części polecenia transakcji. Jeśli pracownik pomocy technicznej potwierdzi szczegóły, wywoływane jest HistoryExecuteCommand/v0001.

Parametry:

NazwaTypWymagane?Opis
keystringJest to klucz serwera zasobów, który podano w ustawieniach Ekonomii Steam twojej aplikacji na stronie partnerskiej.
appiduint3232-bitowe ID aplikacji powiązanej z zasobami.
steamiduint6464-bitowe ID Steam użytkownika, dla którego zwracane są zasoby.
contextiduint6464-bitowe ID kontekstu, w którym znajdują się te zasoby.
commandstringNazwa polecenia historii.
argumentsuint32String argumentów, który został zwrócony z GetUserHistory dla tego polecenia.

Wartości zwrotne

Wynik tej metody powinien być zakodowany w formacie JSON.

Odpowiedź:
  • result
    • success – wartość „true”, jeśli metoda zakończy się powodzeniem. Jeśli serwer zasobów zwraca wartość „false”, to powinien ustawić error jako string z wyjaśnieniem dlaczego.
    • error – string wyjaśniający, dlaczego to wywołanie nie powiodło się. Ta wiadomość zostanie zapisana w dzienniku błędów, który jest dostępny w zakładce „Ekonomia” na stronie Steamworks.
    • actions – tablica działań, które serwer zasobów będzie wykonywał, jeśli pracownik potwierdzi polecenie.
      • id – ID zasobu, na który ma wpływ to działanie.
      • icon_url (opcjonalnie) – ikona do użycia dla tego zasobu. Obraz powinien być w formacie JPEG, GIF lub PNG i mieć wymiary co najmniej 96x96 pikseli. Preferowane są formaty GIF lub PNG, ponieważ obsługują przezroczystość.
      • name – nazwa zasobu, na którym należy wykonać działanie.
      • command – podpolecenie do wykonania na tym zasobie. Ta wartość jest zwracana po potwierdzeniu.
      • note (opcjonalnie) – dodatkowe informacje do wyświetlenia pod nazwą w oknie dialogowym potwierdzenia.
      • argument (opcjonalnie) – string argumentu do przekazania z powrotem, jeśli ta czynność jest wciąż zaznaczona podczas potwierdzania.
      • steamid (opcjonalnie) – 64-bitowy identyfikator SteamID użytkownika, który aktualnie jest właścicielem zasobu. Nazwa użytkownika jest wyświetlana obok nazwy zasobu.
      • optional (opcjonalnie) – jeśli true, pracownik pomocy technicznej będzie mógł odznaczyć tę akcję i pominąć ją podczas wykonywania polecenia. Domyślna wartość — true.
      • default (opcjonalnie) – domyślny stan pola wyboru w oknie dialogowym potwierdzenia. Domyślna wartość — true.

Przykładowe wyjście

{ "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":"" }