SupportGetAssetHistory/v0001 (Steamworks-Dokumentation)

Steamworks-Dokumentation

SupportGetAssetHistory/v0001

Steamworks-Dokumentation > Funktionen > Steam-Inventardienst > Steam-Wirtschaftssystem > SupportGetAssetHistory/v0001

Gibt alle Informationen zurück, die das Supporttool zur Anzeige der Verlaufsdaten eines einzelnen Elements benötigt.

Aufgerufen von: Supportwerkzeug

HTTP-Methode: GET

Parameter:

Name	Typ	Erforderlich	Beschreibung
key	string	✔	Dies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben.
appid	uint32	✔	Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht.
contextid	uint64	✔	Die 64-Bit-ID des Kontext-Containers, in dem diese Elemente gefunden werden können.
assetid	uint64	✔	Die 64-Bit-ID des Kontexts, dessen Verlaufsdaten zurückgegeben werden sollen.

Rückgabewerte

Die Ausgabe dieser Methode sollte im JSON-Format kodiert sein.

Antwort:

result
- success: Gibt den Wert „true“ aus, wenn die Methode erfolgreich war. Wenn der Asset-Server „false“ zurückgibt, sollte error auf einen String gesetzt werden, der den Grund dafür erklärt.
- error: Ein String, der beschreibt, warum dieser Aufruf fehlgeschlagen ist. Diese Nachricht wird im Fehlerprotokoll aufgezeichnet, das im Tab „Wirtschaft“ auf der Webseite von Steamworks verfügbar ist.
- history : Ein Array von Verlaufsereignissen für dieses Element.
  - action: Der Name des Aktionstyps, der in der Transaktion ausgeführt wurde.
  - timestamp: Der Zeitpunkt des Ereignisses, ausgedrückt in Sekunden seit dem 1. Januar 1970.
  - owner: Der Eigentümer des Elements zum Zeitpunkt des Ereigniseintritts.
  - ownerid: Die Steam-ID des Eigentümers des Elements zum Zeitpunkt des Ereigniseintritts, falls verfügbar.
  - data (optional): Weitere Informationen über das Ereignis. Kann der Name eines anderen Spielers, der Name einer Herstellungsformel oder irgendein anderer spielspezifischer Wert sein. Soll dem Supportmitarbeiter ein Bild davon vermitteln, was mit dem Element passiert ist.
  - steamid (optional): Die Steam-ID des anderen in das Ereignis involvierten Spielers, falls sinnvoll.

Beispielausgabe

{ "result": { "history": [ { "action": "Econ SetUnowned", "timestamp": 1321059071, "ownerid": 76561197969518075, "data": "101" }, { "action": "Econ SetOwned", "timestamp": 1321059071, "ownerid": 76561197968459473, "data": "101" }, { "action": "Econ SetUnowned", "timestamp": 1321058861, "ownerid": 76561197968459473, "data": "101" }, { "action": "Econ SetOwned", "timestamp": 1321058861, "ownerid": 76561197969518075, "data": "101" }, { "action": "Added from Bundle", "timestamp": 1292657489, "ownerid": 76561197968459473 } ] , "success": true } }