Ir para o conteúdo
API

WOK API

Assets API - Como conectar | WOK

Beta: busca de itens CS2 observados em inventários públicos

Acesso necessário

Assets / Uso geral

Escolher plano
  1. 1. Crie uma chave

    Entre na conta e escolha o plano adequado.

  2. 2. Configure o ambiente do servidor

    WOK_API_KEY é a chave WOK, não Steam. Não a coloque no navegador, URLs, logs ou instruções para agentes.

  3. 3. Verifique o acesso e faça uma solicitação

    GET /v1/key retorna endpoints e limites sem gastar unidades.

Conta →

Primeira solicitação

Substitua o SteamID ou link de exemplo pelos seus dados.

cURL
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/cs2/assets?paint_index=282&limit=20" \
  -H "Authorization: Bearer $WOK_API_KEY"
Node.js
const key = process.env.WOK_API_KEY;
if (!key) throw new Error('Set WOK_API_KEY on the server');
const response = await fetch("https://woksteamapi.com/v1/cs2/assets?paint_index=282&limit=20", {
  method: 'GET',
  headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
  signal: AbortSignal.timeout(60000),
});
if (!response.ok) throw new Error(`WOK HTTP ${response.status}; inspect Retry-After for 429`);
const result = await response.json();
// Validate the documented status and fields before using result.
Python
import json, os, urllib.request, urllib.error
url = 'https://woksteamapi.com/v1/cs2/assets?paint_index=282&limit=20'
headers = {'Authorization': 'Bearer ' + os.environ['WOK_API_KEY'], 'Content-Type': 'application/json'}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method='GET')
with urllib.request.urlopen(request, timeout=60) as response:
    result = json.load(response)
# Handle HTTPError and validate the documented response status in your application.

Tratar a resposta

items[] contém assetid, observed_owner_steamid, markethashname, float_value/paint_seed/def_index anuláveis, imagens e observações. GET /v1/cs2/assets/coverage mostra cobertura. POST /v1/cs2/assets/find aceita queries[] com até 50 filtros, uma unidade por consulta.

Beta de inventários públicos já obtidos: até 100 mil itens por 7 dias e 5 mil por inventário. Sem nova varredura, inventários privados, sobreposição de trocas ou histórico completo de donos e transferências. Float/seed não prova identidade única. Vazio significa não observado. Find retorna até 20 candidatos por consulta; continue com next_cursor em GET /v1/cs2/assets.

Parâmetros e formato da resposta →

Guia para agentes

Copie a tarefa na sua ferramenta. Defina a chave separadamente no servidor; as instruções não contêm chaves.

MarkdownOpenAPI
Ler instruções
# Conecte ao WOK API

WOK_API_KEY é a chave WOK, não Steam. Não a coloque no navegador, URLs, logs ou instruções para agentes.

https://woksteamapi.com

Authorization: Bearer $WOK_API_KEY

- https://woksteamapi.com/api/openapi.json
- https://woksteamapi.com/mcp.json
- https://woksteamapi.com/api/integration-guide.md
- https://woksteamapi.com/api/specialist-plans.md

1. Revise a stack e crie um adaptador no servidor conforme as convenções do projeto.

2. Chame GET /v1/key uma vez para conferir access.endpoints, capabilities e cotas, sem custo. Planos específicos excluem outras tarefas.

3. Use parâmetros documentados e valide HTTP e status da aplicação. Distinga unavailable, private e empty. Dados ausentes ficam null ou unavailable; nunca invente zeros.

4. Defina prazo total de 60 segundos e limite concorrência. Repita 429/502/503/504 temporários no máximo duas vezes com variação aleatória, respeitando Retry-After e o prazo. Se a cota acabar, aguarde o reset. Não repita 400/401/403 nem recursos sem suporte em loop.

5. Use cache pela data da fonte e una leituras idênticas em andamento. Não consulte por quadro nem force atualização automática.

6. Mantenha moeda, fonte, estatística e horário juntos. Não compare moedas ou snapshots diferentes como o mesmo preço.

7. Use SteamID64 como strings, não números JavaScript. Codifique nomes na URL preservando espaços, ★, barras e caracteres não latinos. Siga a paginação por cursor. Lotes podem cobrar por item ou jogador.

8. Crie exemplos e verificações com mocks primeiro. Peça antes de pedidos reais pagos ou em massa. A instrução não autoriza compras, alterações de plano, cobranças ou e-mails.

9. Informe arquivos, comandos, verificações e recursos sem suporte. Não afirme equivalência de dados ou render sem evidências nas respostas.

## Assets

Beta: busca de itens CS2 observados em inventários públicos

Acesso necessário: Assets / Uso geral

GET /v1/cs2/assets

items[] contém assetid, observed_owner_steamid, markethashname, float_value/paint_seed/def_index anuláveis, imagens e observações. GET /v1/cs2/assets/coverage mostra cobertura. POST /v1/cs2/assets/find aceita queries[] com até 50 filtros, uma unidade por consulta.

Beta de inventários públicos já obtidos: até 100 mil itens por 7 dias e 5 mil por inventário. Sem nova varredura, inventários privados, sobreposição de trocas ou histórico completo de donos e transferências. Float/seed não prova identidade única. Vazio significa não observado. Find retorna até 20 candidatos por consulta; continue com next_cursor em GET /v1/cs2/assets.

Endpoints de dados incluídos:

- /v1/cs2/assets
- /v1/cs2/assets/coverage
- /v1/cs2/assets/find
- /v1/cs2/doppler-phase
- /v1/cs2/inspect
- /v1/cs2/items

https://woksteamapi.com/api/integrations/assets.md

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/cs2/assets?paint_index=282&limit=20" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

Substitua o SteamID ou link de exemplo pelos seus dados.

← Outras tarefas