К содержимому
API

Вопросы о Steam и CS2

Найдите короткий ответ, затем откройте инструкцию с запросами, полями и примерами.

Обновлено

Ответов: 12

Инвентарь и приватность

Почему инвентарь Steam недоступен, хотя профиль открыт?

У профиля, инвентаря, игр и друзей отдельные настройки видимости. Перед расчётом стоимости проверьте статус инвентаря: закрытые или недоступные данные неизвестны, а empty означает подтверждённый пустой инвентарь. Недоступные часы игры тоже нельзя считать нулём.

Открыть инструкцию

Инвентарь и приватность

Почему предметы CS2 после обмена не видны в публичном инвентаре?

Steam может скрывать недавно полученные предметы от других пользователей. Семидневная защита обмена - отдельное правило. Дополнительные предметы из торгового представления WOK имеют неподтверждённый статус защиты, а полнота выборки может быть ограничена. Денежные итоги учитывают публичные предметы. Отсутствие строки не доказывает потерю предмета.

Открыть инструкцию

Кэш и лимиты

Что делать при ошибке 429 Steam и превышении квоты WOK?

Минутный лимит WOK возвращает HTTP 429, а исчерпанная квота тарифа может вернуть 402. При временном ограничении Steam нативный метод инвентаря может вернуть HTTP 200 со status=limited. Учитывайте Retry-After, ограничивайте число повторов и добавляйте задержку со случайным разбросом. Используйте кэш для повторных чтений.

Открыть инструкцию

Кэш и лимиты

Можно ли обновить цены инвентаря без нового запроса в Steam?

Да. Обычное чтение свежего кэша применяет цены локального каталога. Режим refresh_prices=1 обновляет только кэш: при отсутствии или истечении срока снимка вернётся 404 inventory_cache_miss. Проверяйте возраст инвентаря отдельно от времени обновления цен. Запрос расходует квоту WOK; refresh_prices нельзя совмещать с no_cache.

Открыть инструкцию

Кэш и лимиты

Считается ли пакет инвентарей одним запросом квоты?

Пакет расходует одну единицу за каждую уникальную пару SteamID и игры. Допускается до 20 SteamID, четырёх игр и 80 пар. Каждая пара без кэша может потребовать отдельного обращения к Steam. Результаты и ошибки возвращаются по парам, поэтому один сбой не удаляет готовые инвентари.

Открыть инструкцию

Ключи и доступ

Что означают SteamID64, AppID и context ID в запросе инвентаря?

SteamID64 обозначает аккаунт; храните его 17 цифр строкой. AppID определяет игру, context ID - её инвентарь. Для CS2 используются AppID 730 и context 2; параметр WOK game=cs2 выбирает их автоматически. Именную ссылку профиля сначала разрешите через метод профиля и используйте возвращённый SteamID64.

Открыть инструкцию

Inspect и изображения CS2

Как получить float, seed, наклейки и брелоки CS2 по inspect-ссылке?

Передайте inspect-ссылку Steam в POST /v1/cs2/inspect с доступом Inspect. Современные кодированные ссылки разбираются локально, старые - через Steam Game Coordinator. Проверьте status=resolved и capabilities. Неизвестные поля остаются null; временный сбой Steam возвращает 503 с Retry-After. Данные о деталях не определяют цену предмета.

Открыть инструкцию

Цены и источники

Как считается стоимость инвентаря Steam, если у части предметов нет цены?

WOK умножает выбранную цену на количество предметов и суммирует оценённые позиции. Отсутствующие цены остаются null и учитываются в unpriced. Лимит top сокращает список, но не меняет итоги. Оценка по рыночному названию не включает наценку за float, паттерн или наклейки конкретного предмета CS2.

Открыть инструкцию

Цены и источники

Почему цена предмета в API отличается от цены на Торговой площадке Steam?

Сравнивайте одинаковый источник, показатель цены, валюту и время наблюдения. Сохранённая цена лота, медиана продаж и заявка на покупку имеют разный смысл. Каталог WOK возвращает USD, живые лоты CS2 - валюту ответа Steam. Если замена источника недопустима, задайте price_source и strict=1.

Открыть инструкцию

Inspect и изображения CS2

Входят ли скриншоты CS2 и интерактивный 3D Viewer в один тариф?

Создание скриншотов включено в Free и универсальные API-тарифы; доступ специализированного ключа зависит от его методов. Новый рендер возвращает 202: дождитесь Retry-After и запросите результат. Проверяйте предупреждения рендера и деталей. Для интерактивного 3D нужна отдельная подписка Viewer; Viewer Trial даёт 10 открытий за 30 дней.

Открыть инструкцию

Ключи и доступ

Почему для бесплатного WOK API нужно участие в Discord?

Free Developer и Viewer Trial требуют привязанного Discord-аккаунта и действующего участия в сообществе WOK. Вступите, привяжите Discord в кабинете и активируйте доступ там. Отсутствие участия возвращает 403 discord_required; временный сбой проверки - 503 с Retry-After. Текущие лимиты доступны в GET /v1/key.

Открыть инструкцию

Ключи и доступ

Нужен ли ключ Valve Steam API для подключения к WOK?

Методы WOK используют ключ WOK, выданный в кабинете после активации тарифа. Пользовательский ключ Valve, ключ издателя Steamworks или другого провайдера его не заменяют. Отправляйте ключ WOK с сервера в заголовке Authorization: Bearer. GET /v1/key показывает доступные методы и лимиты без расхода единицы квоты.

Открыть инструкцию