อินเตอร์เฟซหลักสำหรับโต้ตอบกับ
ระบบเศรษฐกิจของ Steam รับข้อมูลเพิ่มเติมได้ที่:
ISteamEconomyหากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับวิธีใช้ Steamworks Web API กรุณาอ่าน
ภาพรวมของ Web APIGetHistoryCommandDetails
GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | สตริง | ✔ | คีย์การตรวจสอบสิทธิ์ของผู้จัดจำหน่าย Steamworks Web API |
| appid | uint32 | ✔ | appid ของเกม |
| steamid | uint64 | ✔ | ไอดี Steam ของบัญชีที่จะดำเนินการ |
| command | string | ✔ | คำสั่งสำหรับเรียกใช้ทรัพยากรนั้น |
| contextid | uint64 | ✔ | บริบทที่ใช้รับประวัติข้อมูล |
| arguments | string | ✔ | อาร์กิวเมนต์ที่ให้มากับคำสั่งตั้งแต่ตอนแรก |
หมายเหตุ: การเรียกเมธอดนี้จำเป็นต้องใช้รหัส API ของผู้จัดจำหน่าย ดังนั้น จะ
ต้องเรียก API นี้จากเซิร์ฟเวอร์ที่ปลอดภัย และไคลเอนต์จะไม่มีทางใช้งาน API นี้ได้โดยตรง!
GetUserHistory
GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | string | ✔ | คีย์การตรวจสอบสิทธิ์ของผู้จัดจำหน่าย Steamworks Web API |
| appid | uint32 | ✔ | appid ของเกม |
| steamid | uint64 | ✔ | ไอดี Steam ที่ใช้รับประวัติข้อมูล |
| contextid | uint64 | ✔ | บริบทที่ใช้รับประวัติข้อมูล |
| starttime | uint32 | ✔ | เวลาเริ่มต้นของช่วงประวัติข้อมูลที่ต้องการรวบรวม |
| endtime | uint32 | ✔ | เวลาสิ้นสุดของช่วงประวัติข้อมูลที่ต้องการรวบรวม |
หมายเหตุ: การเรียกเมธอดนี้จำเป็นต้องใช้รหัส API ของผู้จัดจำหน่าย ดังนั้น จะ
ต้องเรียก API นี้จากเซิร์ฟเวอร์ที่ปลอดภัย และไคลเอนต์จะไม่มีทางใช้งาน API นี้ได้โดยตรง!
HistoryExecuteCommands
POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | string | ✔ | คีย์การตรวจสอบสิทธิ์ของผู้จัดจำหน่าย Steamworks Web API |
| appid | uint32 | ✔ | appid ของเกม |
| steamid | uint64 | ✔ | ไอดี Asset ที่จะดำเนินการ |
| contextid | uint64 | ✔ | บริบทที่ใช้รับประวัติข้อมูล |
| actorid | uint32 | ✔ | ไอดีเฉพาะขนาด 32 บิตสำหรับเจ้าหน้าที่ฝ่ายสนับสนุนที่เป็นผู้เรียกใช้คำสั่ง |
หมายเหตุ: การเรียกเมธอดนี้จำเป็นต้องใช้รหัส API ของผู้จัดจำหน่าย ดังนั้น จะ
ต้องเรียก API นี้จากเซิร์ฟเวอร์ที่ปลอดภัย และไคลเอนต์จะไม่มีทางใช้งาน API นี้ได้โดยตรง!
SupportGetAssetHistory
GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | string | ✔ | คีย์การตรวจสอบสิทธิ์ของผู้จัดจำหน่าย Steamworks Web API |
| appid | uint32 | ✔ | appid ของเกม |
| assetid | uint64 | ✔ | ไอดี Asset ที่จะดำเนินการ |
| contextid | uint64 | ✔ | บริบทที่ใช้รับประวัติข้อมูล |
หมายเหตุ: การเรียกเมธอดนี้จำเป็นต้องใช้คีย์ API ของผู้จัดจำหน่าย ดังนั้น จะ
ต้องเรียก API นี้จากเซิร์ฟเวอร์ที่ปลอดภัย และไคลเอนต์จะไม่มีทางใช้งาน API นี้ได้โดยตรง!
UpdateItemDefs
POST https://partner.steam-api.com/IGameInventory/UpdateItemDefs/v0001
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | string | ✔ | คีย์การตรวจสอบสิทธิ์ของผู้จัดจำหน่าย Steamworks Web API |
| appid | uint32 | ✔ | appid ของเกม |
| itemdefs | JSON array | ✔ | คำนิยามไอเท็มอย่างน้อยหนึ่งรายการที่นำเสนอเป็นอาร์เรย์ JSON จะได้รับการอัปเดตหรือสร้างขึ้น |
คำตอบเอาต์พุตจากเมธอดนี้จะเป็นออบเจ็กต์ JSON
- คำตอบ
- success - True หากเมธอดประสบความสำเร็จ ถ้าหากว่าเซิร์ฟเวอร์ Asset ส่งคืนค่า false กลับมา ก็จะตั้งค่า error เป็นสตริงเพื่ออธิบายเหตุผลว่าเกิดอะไรขึ้น
- error - สตริงอธิบายสาเหตุที่การเรียกนี้ล้มเหลว ข้อความดังกล่าวจะถูกบันทึกไว้ในรายการบันทึกความผิดพลาด ซึ่งจะสามารถใช้งานได้ใน แท็บระบบเศรษฐกิจ ในเว็บไซต์ของ Steamworks
- failed - อาร์เรย์ของไอดีคำนิยามไอเท็มที่ได้รับการอัปเดตโดยการเรียกนี้สำเร็จเรียบร้อยแล้ว
ตัวอย่างโค้ดcurl --request POST \
--header "Content-Type: application/x-www-form-urlencoded" \
--form appid=30400 \
--form 'itemdefs=[{"appid":"30400","itemdefid":"418","type":"item","display_type":"bag","name":"Bag of Stuff","description":"This bag contains stuff.","background_color":"993300","tradable": true,"marketable": true,"commodity": true,"tags":"class:human;type:bag"}, {"appid": "30400","itemdefid":"403","type":"item","display_type":"cat","name":"Cat of Bags","description":"This cat contains multitudes."}]'
"https://api.steampowered.com/IGameInventory/UpdateItemDefs/v0001?key=xxxxxx"
ตัวอย่างข้อมูลเอาต์พุต{
"result": {
"updated": [
"418",
"403"
],
"failed": [],
"success": true
}
}
เมื่อคุณอัปเดตคำนิยามไอเท็มทั้งหมดเสร็จเรียบร้อยแล้ว หากคุณแก้ไขธงซื้อขายได้หรือแลกเปลี่ยนได้ ให้เรียก
FlushAssetAppearanceCache เพื่ออัปเดตสถานะของไอเท็มที่เกี่ยวข้องในตลาดได้ทันที การเรียกนี้จะใช้การดำเนินการของเซิร์ฟเวอร์ที่มีราคาแพง ดังนั้นจึงควรทำหลังจากอัปเดตทั้งหมดเสร็จสิ้นแล้ว และโดยเฉพาะเมื่อมีการปรับเปลี่ยนค่าธงเหล่านี้เท่านั้น