จะคืนค่าราคาและหมวดหมู่ของไอเท็มที่ผู้ใช้สามารถสั่งซื้อได้กลับมาให้ หากมีการกำหนดตัวกรองคลาส ก็ควรจะกรองผลลัพธ์หาไอเท็มใด ๆ ที่คืนค่าที่ประกอบไปด้วยคู่ คีย์/ค่า ตามระบุอย่างน้อย 1 คู่ ตัวอย่างเช่น ถ้าได้กำหนดฟิลเตอร์ 2 ตัว
def_index/40 และ
def_index/50 จะคืนกลับมาให้แต่ผลลัพธ์ของไอเท็มที่มีคุณสมบัติคลาส def_index ตั้งเอาไว้ที่ 40 หรือ 50 เท่านั้น
ถูกเรียกโดย: การซื้อผ่านเว็บ
เมธอด HTTP: GET
พารามิเตอร์:
| ชื่อ | ประเภท | ที่ต้องการ | คำอธิบาย |
|---|
| key | string | ✔ | นี่คือ "คีย์เซิร์ฟเวอร์ทรัพยากรy" ที่คุณจัดไว้ให้ในการตั้งค่าระบบเศรษฐกิจของ Steam สำหรับแอปของคุณบนเว็บไซต์พันธมิตร |
| appid | uint32 | ✔ | ไอดีแอปประเภท 32 บิต ของแอปพลิเคชันที่เกี่ยวข้องกับทรัพยากรนั้น |
| language | string | ✔ | รหัสภาษาประเภท ISO639-1 พร้อมด้วยรหัสประเทศประเภท ISO 3166-1 alpha 2 ของภาษาที่จะส่งผลลัพธ์กลับคืน ยกตัวอย่างเช่น en_US, de_DE, zh_CN และ ko_KR ค่าเริ่มต้น: ไม่มี |
| currency | string | ✔ | รหัสสกุลเงิน ISO 4217 ที่เป็นตัวเลือก หากกำหนดไว้ ก็จำเป็นต้องคืนค่าเฉพาะราคาสำหรับสกุลเงินนี้เท่านั้น |
| class_count | uint32 | ✔ | จำนวนตัวระบุคลาสที่ระบุไว้สำหรับการกรอง |
| class_name# | string | ✔ | ชื่อของตัวระบุที่จะกรอง โดยจะมีหนึ่งในพารามิเตอร์ต่อไปนี้ไว้ให้แก่หมายเลขแต่ละหมายเลขระหว่าง 0 ถึง class_count-1 (เช่น class_name0, class_name1, class_name2) |
| class_value# | string | ✔ | ค่าของตัวระบุที่จะกรอง โดยจะมีหนึ่งในพารามิเตอร์เหล่านี้สำหรับแต่ละหมายเลขระหว่าง 0 ถึง class_count-1 (เช่น class_value0, class_value1, class_value2) |
คืนค่า
เอาต์พุตจากเมธอดนี้ควรถูกเข้ารหัสไว้ในรูปแบบของ JSON
คำตอบ: -
result
-
success - True หากเมธอดประสบความสำเร็จ หากเซิร์ฟเวอร์ Asset คืนค่า false กลับมา ก็จะตั้งค่า error เป็นสตริงเพื่ออธิบายเหตุผลว่าเกิดอะไรขึ้น
-
error - สตริงอธิบายสาเหตุที่การเรียกนี้ล้มเหลว ข้อความดังกล่าวจะถูกบันทึกไว้ในรายการบันทึกความผิดพลาด ซึ่งจะสามารถใช้งานได้ใน แท็บระบบเศรษฐกิจ ในเว็บไซต์ของ Steamworks
-
assets - อาร์เรย์ของ Asset ที่สามารถสั่งซื้อได้
-
name - ชื่อของ Asset นี่คือชื่อที่จะถูกส่งเข้าไปใน StartWebAssetTransaction/v0001
-
prices - จะบรรจุองค์ประกอบลูก (child element) ของแต่ละสกุลเงินที่รองรับ เว้นเสียแต่ว่ามีการกำหนดค่าตัวกรองสกุลเงิน ถ้าเป็นเช่นนั้นก็ควรจะใส่ไว้เฉพาะแต่ราคาของสกุลเงินดังกล่าวเท่านั้น โดยคีย์ลูก (child key) แต่ละคีย์จะต้องเป็นรหัสสกุลเงินประเภท ISO 4217 และจะต้องรายงานค่าเป็นประเภทข้อมูลประเภท unsigned integer กรุณาอ่าน สกุลเงินที่รองรับ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการรายงานค่านี้
-
original_prices - หากว่ากำลังลดราคาให้ไอเท็มชิ้นดังกล่าวนี้อยู่ ก็จะบรรจุไปด้วยราคาเต็มของไอเท็มชิ้นนี้ในแบบเดียวกันกับ prices ซึ่งหากไม่ได้ลดราคาไอเท็มชิ้นดังกล่าว ก็ไม่ควรแสดงให้เห็น
-
class - อาร์เรย์ของตัวระบุคลาสของ Asset ที่ได้นิยามค่าเอาไว้ตามเกม กรุณาอ่าน GetContextContents/v0001 สำหรับรายละเอียดเกี่ยวกับรูปแบบที่ตัวระบุคลาสเหล่านี้ควรจะรับได้
-
tags - อาร์เรย์ของแท็กที่จะใช้งานกับไอเท็ม กรุณาดูผลลัพธ์ตัวอย่างสำหรับข้อมูลเพิ่มเติม tags ที่อยู่ใน result จะบรรจุชื่อแสดงผลที่ได้รับการแปลแล้วสำหรับแต่ละแท็ก
-
tags - จะบรรจุองค์ประกอบลูก (child element) ให้กับแต่ละแท็กที่ได้รับรองรับ โดยไม่สนว่าจะระบุตัวกรองอะไรไว้ก็ตาม หากมีการระบุพารามิเตอร์ของภาษา ค่าที่ได้ควรจะเป็นข้อความที่ได้รับการแปลภาษาแล้ว หรือไม่เช่นนั้น หากไม่มีการระบุภาษา ก็ควรจะเป็นโทเค็นการแปลภาษาหรือตัวระบุตัวอื่น
ข้อมูลเอาต์พุตตัวอย่าง
ข้อมูลเอาต์พุตทางด้านล่างนี้เป็นตัวอย่างของการร้องขอที่ใส่พารามิเตอร์เข้าไปด้วย:
language=english&class_count=3&class_name0=def_index&class_value0=5021&class_name1=def_index&class_value1=58&class_name2=def_index&class_value2=647{
"result": {
"success": true
"assets": [
{
"name": "5021",
"prices": {
"USD": 249,
"GBP": 199,
"EUR": 199,
"RUB": 7400
},
"class": [
{
"name": "def_index",
"value": "5021"
}
]
,
"tags": [
"Tools"
]
},
{
"name": "58",
"prices": {
"USD": 74,
"GBP": 44,
"EUR": 55,
"RUB": 2250
},
"original_prices": {
"USD": 99,
"GBP": 59,
"EUR": 74,
"RUB": 3000
},
"class": [
{
"name": "def_index",
"value": "58"
}
]
,
"tags": [
"Weapons"
]
},
{
"name": "647",
"prices": {
"USD": 749,
"GBP": 499,
"EUR": 549,
"RUB": 22400
},
"class": [
{
"name": "def_index",
"value": "647"
}
]
,
"tags": [
"New",
"Misc"
]
}
]
,
"tags": {
"Headgear": "Hats",
"Misc": "Misc",
"Weapons": "Weapons",
"Tools": "Tools",
"Collections": "Collections",
"Bundles": "Bundles",
"Maps": "Maps",
"New": "New Releases"
},
}
}
