A interface principal para interação com a
Economia Steam.
Consulte também:
ISteamEconomy.
Para mais informações sobre como usar a Web API do Steamworks, consulte a
Visão geral da Web API.
GetHistoryCommandDetails
GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/
Nome | Tipo | Obrigatório | Descrição |
key | string | ✔ | Chave de autenticação da distribuidora para a Web API do Steamworks. |
appid | uint32 | ✔ | O AppID do jogo. |
steamid | uint64 | ✔ | O ID Steam da conta a operar. |
command | string | ✔ | O comando a executar no ativo. |
contextid | uint64 | ✔ | O contexto cujo histórico recuperar. |
arguments | string | ✔ | Os argumentos informados com o comando. |
AVISO: este método requer uma chave da distribuidora. Por isso, a API
DEVE ser chamada a partir de um servidor seguro, nunca a partir de clientes!
GetUserHistory
GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/
Nome | Tipo | Obrigatório | Descrição |
key | string | ✔ | Chave de autenticação da distribuidora para a Web API do Steamworks. |
appid | uint32 | ✔ | O AppID do jogo. |
steamid | uint64 | ✔ | O ID Steam cujo histórico recuperar. |
contextid | uint64 | ✔ | O contexto cujo histórico recuperar. |
starttime | uint32 | ✔ | O horário inicial do intervalo do histórico a recuperar. |
endtime | uint32 | ✔ | O horário final do intervalo do histórico a recuperar. |
AVISO: este método requer uma chave da distribuidora. Por isso, a API
DEVE ser chamada a partir de um servidor seguro, nunca a partir de clientes!
HistoryExecuteCommands
POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/
Nome | Tipo | Obrigatório | Descrição |
key | string | ✔ | Chave de autenticação da distribuidora para a Web API do Steamworks. |
appid | uint32 | ✔ | O AppID do jogo. |
steamid | uint64 | ✔ | O ID do ativo no qual operar. |
contextid | uint64 | ✔ | O contexto cujo histórico recuperar. |
actorid | uint32 | ✔ | Um ID de 32 bits único, que identifica o agente do suporte que está executando o comando. |
AVISO: este método requer uma chave da distribuidora. Por isso, a API
DEVE ser chamada a partir de um servidor seguro, nunca a partir de clientes!
SupportGetAssetHistory
GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/
Nome | Tipo | Obrigatório | Descrição |
key | string | ✔ | Chave de autenticação da distribuidora para a Web API do Steamworks. |
appid | uint32 | ✔ | O AppID do jogo. |
assetid | uint64 | ✔ | O ID do ativo no qual operar. |
contextid | uint64 | ✔ | O contexto cujo histórico recuperar. |
AVISO: este método requer uma chave da distribuidora. Por isso, a API
DEVE ser chamada a partir de um servidor seguro, nunca a partir de clientes!
UpdateItemDefs
POST https://partner.steam-api.com/IGameInventory/UpdateItemDefs/v0001
Nome | Tipo | Obrigatório | Descrição |
key | string | ✔ | Chave de autenticação da distribuidora para a Web API do Steamworks. |
appid | uint32 | ✔ | O AppID do jogo. |
itemdefs | Vetor JSON | ✔ | Uma ou mais definições de itens, apresentadas como um vetor JSON, para atualizar ou criar. |
RespostaA resposta deste método será um objeto no formato JSON.
- response
- 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;
- failed — Um vetor de IDs de definições de item atualizadas com sucesso por esta chamada.
Código de exemplocurl --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"
Exemplo de saída{
"result": {
"updated": [
"418",
"403"
],
"failed": [],
"success": true
}
}
Depois de atualizar todas as definições de item desejadas, se houve alteração nos indicadores de comercialização (marketable) ou troca (tradeable), chame
FlushAssetAppearanceCache para atualizar imediatamente o estado dos itens associados no Mercado. Esta chamada executa uma operação custosa no servidor, então chame-a apenas depois de concluir todas as atualizações e apenas se esses indicadores foram modificados.