WepAPI
From Team Fortress Wiki
O Steam Web API é documentado em http://steamcommunity.com/dev e em http://developer.valvesoftware.com/wiki/Steam_Web_API. O mapeamento dos dados do API para cada formato de dado é descrito abaixo.
Esta página documenta as chamadas de API web que permitem que você para recuperar dados do sistema de itens do Team Fortress 2.
Chamadas ao TF2 Web API exigem uma chave válida do Steam Web API para funcionar. Você pode pegar sua própria API Key aqui. Cada URL de exemplo só irá funcionar após a substituição "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" com a sua chave API.
Contents |
Elementos comuns
Argumentos
Todos os Métodos do TF2 usam os seguintes argumentos em suas URLs:
- key: Sua chave do Steam Web API. Sem ela, o server irá retornar um estado "403 Forbidden HTTP".
- format (opcional): O formato para retornar os dados em ("json" para JSON, "xml" para XML, ou "vdf" para VDF). A estrutura das informações para cada formato é descrito em http://developer.valvesoftware.com/wiki/Steam_Web_API#Formats. Se nenhum formato é especificado, os dados serão retornadas com o JSON padrão.
Estrutura de Resultado
Todos os métodos do TF2 retornam um objeto "result" contendo um código de status (em "status") e ambos dados exigidos ou um status de mensagem explicando porque os dados não retornaram (em "statusDetail").
Terminologia
Uma "string tokenizada" se refere á uma string contendo tokens "#"-prefixados que são substituídos com a string equivalente ao VDF do jogo para o idioma escolhido. Por exemplo "TF_Weapon_Jar" é definido como ""Jar-based Karate"" no tf/resource/tf_english.txt (achado no "team fortress 2 content.gcf").
Métodos
- GetSchema
- Retorna informação sobre os itens em um jogo suportado.
- GetPlayerItems
- Lista itens da mochila de um jogador.
- GetAssetPrices
- Retorna o preço dos itens da economia.
- GetAssetClassInfo
- Metadados dos assets
- ResolveVanityURL
- Junta partes de URL vanity em um ID de 64 bit.
- GetNewsForApp
- Notícias de vários jogos
- GetGlobalAchievementPercentagesForApp
- Estatísticas mostrando quanto da base de jogadores desbloquearam varias conquistas.
- GetPlayerSummaries
- Dados da conta do usuário
Notas
Lista de IDs válidos
- 440: Team Fortress 2
- 520: Team Fortress 2 Public Beta
- 620: Portal 2
Métodos Exigindo um ID de Usuário de 64-bits
Se a ID de um usuário de 64 bits não está prontamente disponível, ela pode ser obtida por uma transação OpenID ou buscando a versão XML da página de perfil do usuário da Comunidade. Isto é realizado adicionando "?xml = 1" para uma URL normal da comunidade (por exemplo: http://steamcommunity.com/id/stragglerastic?xml=1) e ler o valor dado na tag "steamID64".
Implementações
- "Condensador do Steam" Ruby, PHP, e Java library.
- TF2 Web APpy Uma pequena classe de Python.
- Steamodd Módulo Python
- libsc Uma biblioteca Objective-C para o IOS (4.0+) e framework para o Mac OS X (10.6+)
Veja Também
- Feedback para pedidos, sugestões e problemas. (inglês)
- Steam Web API para mais informações e outros métodos.