사용자가 구매할 수 있는 아이템의 가격 및 분류를 반환합니다. 클래스 필터를 지정한 경우, 반환된 아이템에 지정된 키/값 쌍이 최소 하나라도 포함되어 있으면 결과를 필터링해야 합니다. 예를 들어,
def_index/40과
def_index/50 필터를 지정한 경우, 40 혹은 50으로 설정된 def_index 클래스 속성을 가진 아이템의 결과만 반환되어야 합니다.
호출: 웹 구매
HTTP 메서드: GET
매개변수:
| 이름 | 종류 | 필수 | 설명 |
|---|
| key | string | ✔ | 이것은 귀하가 파트너 사이트에 제공한 귀사 앱의 Steam 경제 설정에 있는 "자산 서버 키"입니다. |
| appid | uint32 | ✔ | 에셋과 연관된 애플리케이션의 32비트 앱 ID. |
| 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 형식으로 인코딩되어야 합니다.
응답: -
결과
-
success - 메서드가 성공일 때 true. 에셋 서버가 false를 반환하면, 그 원인을 설명하는 error를 문자열에 설정해야 합니다.
-
error - 실패 원인을 설명하는 문자열. 이 메시지는 Steamworks 사이트의 경제 탭에 있는 오류 이력에 기록됩니다.
-
assets - 구매할 수 있는 에셋 모음.
-
name - 에셋의 이름. StartWebAssetTransaction/v0001에 전달될 이름입니다.
-
prices - 통화 필터를 지정하지 않으면 지원되는각 통화의 하위 요소를 보유하며, 필터를 지정하면 해당 통화의 가격만 보유합니다. 각 하위 키는 ISO 4217 통화 코드이어야 하며 값은 무부호 정수로 보고되어야 합니다. 값을 보고하는 방법에 대한 자세한 내용은 지원되는 통화을 참조하세요.
-
original_prices - 아이템이 세일 중일 경우, prices와 같은 방식으로 아이템의 정상 가격이 포함됩니다. 아이템이 세일 중이 아닌 경우 생략합니다.
-
class - 게임에 정의된 에셋 클래스 식별자 모음. 이 클래스 식별자가 따르는 형식에 대한 자세한 내용은 GetContextContents/v0001를 참조하세요.
-
tags - 아이템에 적용되는 태그 혹은 카테고리 모음. 자세한 내용은 예시 출력을 참조하세요. tags는 result 아래의 모음으로 각 태그의 현지화된 표시 이름을 가집니다.
-
tags - 지정한 필터에 관계없이 지원되는 각 태그의 하위 요소를 포함합니다. 만일 언어 매개변수가 지정되었거나, 현지화 토큰이거나, 다른 식별자일 때 언어가 지정되지 않았다면 값을 현지화해야 합니다.
예시 출력
아래의 출력은 매개변수를 포함한 요청의 예시입니다.
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"
},
}
}
