SupportGetAssetHistory/v0001 (Tài liệu Steamworks)

Tài liệu Steamworks

SupportGetAssetHistory/v0001

Tài liệu về Steamworks > Tính năng > Dịch vụ kho đồ Steam > Hệ thống kinh tế Steam > SupportGetAssetHistory/v0001

Hàm này trả về mọi thứ công cụ hỗ trợ cần để hiển thị lịch sử cho một asset.

Gọi bởi: Công cụ hỗ trợ

Phương thức HTTP: GET

Tham số:

Tên	Loại	Bắt buộc	Mô tả
key	string	✔	Đây là "Mã máy chủ asset" mà bạn cung cấp trong Thiết lập hệ thống kinh tế Steam của ứng dụng trên trang đối tác.
appid	uint32	✔	AppID 32-bit của ứng dụng liên kết với asset.
contextid	uint64	✔	ID 64-bit của context chứa asset này.
assetid	uint64	✔	ID 64-bit của asset để trả lịch sử về.

Trả về

Kết quả có được từ phương thức này nên được mã hóa theo định dạng JSON.

Phản hồi:

result
- success - True nếu phương thức trả về thành công. Nếu máy chủ asset trả về false, nên đặt error cho chuỗi giải thích lý do.
- error - một chuỗi mô tả lý do lệnh gọi này thất bại. Thông điệp sẽ được ghi lại trong nhật ký lỗi, có thể tìm thấy tại thẻ Kinh tế trên trang Steamworks.
- history - một mảng sự kiện lịch sử của asset này.
  - action - Tên của loại hành động do sự kiện đại diện.
  - timestamp - Thời điểm diễn ra sự kiện, thể hiện bằng giây kể từ 01/01/1970.
  - owner - Chủ sở hữu asset khi sự kiện diễn ra.
  - ownerid - SteamID của chủ sở hữu asset khi sự kiện diễn ra, nếu có.
  - data (không bắt buộc) - Thông tin thêm về sự kiện. Đây có thể là tên người chơi khác, tên công thức chế tạo, hay bất kỳ giá trị cụ thể nào khác của trò chơi. Cho nhân viên hỗ trợ vài thông tin về việc đã xảy ra với asset này.
  - steamid (không bắt buộc) - SteamID của người chơi khác tham gia vào sự kiện, nếu có.

Kết quả ví dụ

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