Retorna preços e categorias para itens disponíveis para compra por usuários. Se houver filtros de classe especificados, os resultados devem ser filtrados sempre que um dos itens retornados contiver um ou mais dos pares de chave/valor especificados. Por exemplo, se dois filtros
def_index/40 e
def_index/50 forem especificados, apenas resultados com a propriedade de classe def_index com valor 40 ou 50 deverão ser retornados.
Chamado por: Compras na web
Método HTTP: GET
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|
| key | string | ✔ | Esta é a "Chave do servidor de ativos" fornecida nas "Configurações da economia Steam" do aplicativo do site do parceiro. |
| appid | uint32 | ✔ | O AppID de 32 bits do aplicativo associado aos ativos. |
| language | string | ✔ | Código de idioma ISO639-1 seguido de código de país ISO 3166-1 alfa 2 do idioma no qual retornar os resultados. Exemplos: en_US, de_DE, pt_BR, zh_CN e ko_KR. Padrão: nenhum |
| currency | string | ✔ | Um código de moeda ISO 4217 opcional. Se especificado, apenas preços para esta moeda precisam ser retornados. |
| class_count | uint32 | ✔ | A quantidade de identificadores de classe especificados para filtragem. |
| class_name# | string | ✔ | O nome do identificador usado para filtragem. Haverá um desses parâmetros para cada número entre 0 e class_count-1. (ex.: class_name0, class_name1, class_name2) |
| class_value# | string | ✔ | O valor do identificador usado para filtragem. Haverá um desses parâmetros para cada número entre 0 e class_count-1. (ex.: class_value0, class_value1, class_value2) |
Retorna
A saída deste método deve ser codificada no formato JSON.
Resposta: -
result
-
success — True se bem-sucedida. Se o servidor de ativos está retornando false, o parâmetro error deve conter uma string com o motivo.
-
error — Uma string que descreve o motivo da falha da chamada. A mensagem será armazenada no relatório de erro, disponível na aba Economia do painel de administração de aplicativo no site do Steamworks.
-
assets — Um vetor de ativos disponíveis para compra.
-
name — O nome do ativo. Será o mesmo nome passado para o método StartWebAssetTransaction/v0001.
-
prices — Contém um elemento-filho para cada uma das moedas disponíveis, a não ser que haja um filtro de moeda especificado; nesse caso, inclua apenas o preço para a moeda informada. Cada chave-filha deve ser o mesmo código de moeda ISO 4217 e o valor deve ser passado como um inteiro sem sinal. Consulte Moedas disponíveis para mais informações sobre como passar esse valor.
-
original_prices — Se o item estiver em oferta, contém os preços originais do item no mesmo formato do parâmetro prices. Omita se o item não estiver em oferta.
-
class — Um vetor de identificadores de classe de ativos definidos pelo jogo. Consulte GetContextContents/v0001 para detalhes sobre o formato usado pelos identificadores de classe.
-
tags — Um vetor de marcadores ou categorias que se aplicam ao item. Consulte o exemplo de saída abaixo para mais informações. O vetor tags abaixo de result contém o nome de exibição localizado para cada marcador.
-
tags — Contém um elemento-filho para cada um dos marcadores disponíveis, independentemente dos filtros especificados. Os valores devem conter texto localizado se o parâmetro "language" for especificado, ou um token de localização ou outro identificador se não houver idioma especificado.
Exemplo de saída
A saída abaixo é um exemplo para uma requisição com parâmetros:
language=brazilian&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": "Chapéus",
"Misc": "Diversos",
"Weapons": "Armas",
"Tools": "Ferramentas",
"Collections": "Coleções",
"Bundles": "Conjuntos",
"Maps": "Mapas",
"New": "Novidades"
},
}
}
