Ir para o conteúdo
API

Perguntas sobre Steam e CS2

Encontre uma resposta direta e abra o guia com requisições, campos e exemplos.

Atualizado

12 respostas

Inventário e privacidade

Por que meu inventário Steam está indisponível se meu perfil é público?

Perfil, inventário, jogos e amigos têm configurações de visibilidade separadas. Verifique o status do inventário antes de mostrar o valor: dados privados ou indisponíveis são desconhecidos; empty indica um inventário vazio observado com sucesso. Horas de jogo ausentes também são desconhecidas.

Ler o guia

Inventário e privacidade

Por que itens de CS2 recém-trocados não aparecem no inventário público?

A Steam pode ocultar itens recém-adquiridos de outros usuários. A proteção de trocas por sete dias é uma regra separada. Os candidatos opcionais da visualização de trocas da WOK têm proteção não verificada e cobertura possivelmente parcial; os totais monetários continuam contando os itens públicos. Uma linha ausente não comprova perda.

Ler o guia

Cache e limites

Como tratar o erro 429 do inventário Steam e os limites da WOK?

O limite por minuto da WOK retorna HTTP 429; a cota esgotada pode retornar 402. O inventário nativo pode responder HTTP 200 com status=limited quando a Steam está indisponível. Respeite Retry-After e limite as tentativas com espera e variação aleatória. Reutilize o cache; nenhuma API garante a disponibilidade da Steam.

Ler o guia

Cache e limites

Posso atualizar os preços do inventário sem consultar a Steam novamente?

Sim. Uma leitura do cache válido aplica preços do catálogo local. Use refresh_prices=1 para atualizar apenas pelo cache: um inventário ausente ou expirado retorna 404 inventory_cache_miss. Confira separadamente a idade do inventário e dos preços. A chamada consome unidades WOK e refresh_prices não pode ser combinado com no_cache.

Ler o guia

Cache e limites

Um lote de inventários consome apenas uma unidade de requisição?

O lote cobra uma unidade por combinação única de SteamID e jogo. Aceita até 20 SteamIDs, quatro jogos e 80 combinações. Cada combinação sem cache pode exigir uma consulta separada à Steam. Resultados e erros são individuais; uma falha não descarta inventários já concluídos.

Ler o guia

Chaves e acesso

O que são SteamID64, AppID e context ID em uma consulta de inventário?

SteamID64 identifica a conta; preserve seus 17 dígitos como texto. AppID identifica o jogo e context ID seleciona o inventário. CS2 usa AppID 730 e context 2. Na WOK, game=cs2 seleciona esses valores. Resolva primeiro um perfil com nome personalizado pela rota de perfil para obter seu SteamID64.

Ler o guia

Inspect e imagens CS2

Como obter float, seed, adesivos e amuletos de CS2 por um link inspect?

Envie o link inspect da Steam para POST /v1/cs2/inspect com acesso Inspect. Links modernos são decodificados localmente; os antigos usam trabalhadores do Game Coordinator da Steam. Confira status=resolved e capabilities. Campos desconhecidos ficam em null; uma falha temporária retorna 503 com Retry-After. Os dados dos acessórios não determinam o preço.

Ler o guia

Preços e fontes

Como calcular o valor do inventário Steam quando alguns itens não têm preço?

A WOK multiplica o preço selecionado pela quantidade possuída e soma os itens com preço. Preços ausentes ficam em null e entram em unpriced. O limite top encurta a lista sem alterar os totais. Estimativas por nome não incluem o valor adicional de float, padrão ou adesivos aplicados a um item específico de CS2.

Ler o guia

Preços e fontes

Por que o preço de um item na API difere do preço que vejo no Mercado Steam?

Compare a mesma fonte, estatística de preço, moeda e horário da observação. Um anúncio salvo, a mediana de vendas e uma ordem de compra representam preços diferentes. O catálogo WOK usa USD; anúncios atuais de CS2 usam a moeda retornada pela Steam. Informe price_source e strict=1 para impedir outra fonte.

Ler o guia

Inspect e imagens CS2

Capturas de CS2 e o visualizador 3D interativo estão no mesmo plano?

Capturas estão incluídas no Free e nos planos API gerais; chaves especializadas dependem do escopo. Uma nova renderização retorna 202: aguarde Retry-After e consulte o resultado. Confira avisos de renderização e acessórios. O 3D interativo exige uma assinatura Viewer separada; Viewer Trial inclui 10 aberturas por 30 dias.

Ler o guia

Chaves e acesso

Por que o acesso gratuito à WOK API exige participação no Discord?

Free Developer e Viewer Trial exigem uma conta Discord vinculada que permaneça na comunidade WOK. Entre na comunidade, vincule o Discord na sua conta e ative o acesso ali. Sem participação, o retorno é 403 discord_required; uma falha temporária de verificação retorna 503 com Retry-After. Confira os limites em GET /v1/key.

Ler o guia

Chaves e acesso

Preciso de uma chave Valve Steam API para conectar à WOK?

Os endpoints WOK usam a chave WOK emitida na sua conta após ativar um plano. Chaves de usuário Valve, editor Steamworks ou outro provedor não a substituem. Envie a chave WOK pelo servidor no cabeçalho Authorization: Bearer. GET /v1/key mostra o escopo e os limites sem consumir uma unidade.

Ler o guia