# Подключение 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. Укажи изменённые файлы, команды настройки, проверки и неподдерживаемые возможности. Не заявляй равенство данных или рендера без подтверждения ответами.

## 3D-просмотр

3D-просмотр оружия и поддерживаемых скинов CS2. Откройте inspect-ссылку, меняйте float и pattern seed, вращайте модель и сохраняйте PNG.

Необходимый доступ: Free: 10 открытий предметов за 30 дней. В платные тарифы включены viewer и своё оформление. Просмотры не расходуют квоту запросов API.

GET /v1/key

Используйте токен просмотра и iframe по инструкции /api/cs2-3d-viewer.md. Ключ API нельзя помещать в URL iframe.

В кабинете создайте код встраивания. Вращение и изменение float/seed не расходуют дополнительные просмотры. Проверяйте возможности рендера: точная геометрия поддерживается не для всех деталей.

https://woksteamapi.com/api/cs2-3d-viewer.md

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/key" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

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