# Підключення 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. Кешуй за часом джерела й об’єднуй однакові поточні запити. Не опитуй на кожному кадрі й не вмикай автоматичний force-refresh.

6. Зберігай валюту, джерело ціни, показник і час спостереження разом. Не порівнюй різні валюти й знімки джерел як одну ціну.

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

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

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

## Assets

Бета: пошук предметів CS2 у зафіксованих публічних інвентарях

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

GET /v1/cs2/assets

items[] містить assetid, observed_owner_steamid, markethashname, nullable float_value/paint_seed/def_index, зображення та спостереження. GET /v1/cs2/assets/coverage показує охоплення. POST /v1/cs2/assets/find приймає queries[] до 50 фільтрів, одиниця за запит.

Бета вже отриманих публічних інвентарів: до 100 тис. предметів за 7 днів, до 5 тис. на інвентар. Без нового сканування, приватних/торгових накладених інвентарів і повної історії власників чи передач. Float/seed не доводить унікальність. Порожньо означає «не спостерігався». Find повертає до 20 кандидатів; далі використовуйте next_cursor у GET /v1/cs2/assets.

Включені методи даних:

- /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-посилання своїми даними.