WOK API

Поиск предметов CS2: API float, seed и инвентарей | WOK

Бета: поиск CS2-предметов в наблюдаемых публичных инвентарях

Необходимый доступ

Assets / Универсальные

Выбрать тариф

1. Создайте ключ
Войдите в аккаунт и выберите подходящий тариф.
2. Настройте окружение сервера
WOK_API_KEY - ключ WOK, а не Steam. Не добавляйте его в код браузера, URL, логи или задачу агенту.
3. Проверьте доступ и выполните запрос
GET /v1/key возвращает доступные методы и лимиты без расхода квоты.

Аккаунт →

Первый запрос

Замените пример SteamID или inspect-ссылку своими данными.

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.

Обработка ответа

items[] содержит assetid, observed_owner_steamid, markethashname, float_value, paint_seed, def_index, изображения и время наблюдения. Неизвестные float и seed равны null. Метод coverage показывает размер индекса; find принимает до 50 фильтров с оплатой по числу запросов.

Бета: выборка уже полученных публичных инвентарей. До 100 000 предметов за 7 дней, до 5 000 из одного инвентаря. Поиск не делает новых запросов в Steam. Закрытые инвентари и история передач недоступны. Совпадение float/seed не доказывает уникальность. Пустой результат означает «не наблюдался».

Параметры и формат ответа →

Инструкция для агента

Скопируйте задачу в свой инструмент разработки. Ключ задайте отдельно на сервере: в инструкции его нет.

Markdown OpenAPI

Посмотреть инструкцию

# Подключение WOK API

WOK_API_KEY - ключ WOK, а не Steam. Не добавляйте его в код браузера, URL, логи или задачу агенту.

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. Изучи стек проекта и сделай серверный адаптер по принятым в проекте правилам.

2. Один раз вызови GET /v1/key: проверь access.endpoints, capabilities и квоты. Это не расходует единицы. Специализированный тариф не включает другие направления.

3. Используй параметры из документации и проверяй HTTP-статус и статус приложения. Различай unavailable, private и empty. Отсутствующие данные - null или unavailable, а не выдуманный ноль.

4. Задай общий таймаут 60 секунд и ограничь параллелизм. Временные 429/502/503/504 повторяй максимум дважды со случайной задержкой, учитывая Retry-After и общий таймаут. При исчерпании квоты жди сброса. Не зацикливай 400/401/403 и неподдерживаемые функции.

5. Кешируй по времени источника и объединяй одинаковые текущие запросы. Не опрашивай API на каждом кадре и не включай автоматический force-refresh.

6. Храни валюту, источник цены, показатель и время наблюдения вместе. Не сравнивай разные валюты и снимки источников как одну цену.

7. Передавай SteamID64 строкой, не числом JavaScript. Кодируй названия в URL, сохраняя пробелы, ★, вертикальные черты и нелатинские символы. Используй курсорную пагинацию. Пакеты могут оплачиваться за предмет или игрока.

8. Сначала сделай примеры и проверки на моках. Запроси разрешение перед платными живыми или массовыми запросами. Эта инструкция не разрешает покупки, изменение тарифов, реальные списания и отправку писем.

9. Укажи изменённые файлы, команды настройки, проверки и неподдерживаемые возможности. Не заявляй равенство данных или рендера без подтверждения ответами.

## Поиск экземпляров CS2

Бета: поиск CS2-предметов в наблюдаемых публичных инвентарях

Необходимый доступ: Assets / Универсальные

GET /v1/cs2/assets

items[] содержит assetid, observed_owner_steamid, markethashname, float_value, paint_seed, def_index, изображения и время наблюдения. Неизвестные float и seed равны null. Метод coverage показывает размер индекса; find принимает до 50 фильтров с оплатой по числу запросов.

Бета: выборка уже полученных публичных инвентарей. До 100 000 предметов за 7 дней, до 5 000 из одного инвентаря. Поиск не делает новых запросов в Steam. Закрытые инвентари и история передач недоступны. Совпадение float/seed не доказывает уникальность. Пустой результат означает «не наблюдался».

Включённые методы данных:

- /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"
```

Замените пример SteamID или inspect-ссылку своими данными.

← Другие направления