WOK API
Inventory API - Як підключити | WOK
Інвентарі, пакетні запити, знімки й локальні ринкові ціни
Необхідний доступ
Inventory / Універсальні
Обрати тариф- 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/inventory?steam_id=76561198000000001&game=cs2" \
-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/inventory?steam_id=76561198000000001&game=cs2", {
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/inventory?steam_id=76561198000000001&game=cs2'
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, markethashname, image, prices і currency. Inspect-поля - лише за наявності.
Діє приватність Steam. Порожній публічний і недоступний інвентар - різні стани. Лічильники Rust у Players. Пакети інвентарів оплачуються за кожного запитаного гравця.
Параметри й формат відповіді →Інструкція для агента
Скопіюйте завдання в інструмент розробки. Ключ задайте окремо на сервері: в інструкції його немає.
Переглянути інструкцію
# Підключення 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. Укажи змінені файли, команди, перевірки й непідтримувані можливості. Не заявляй рівність даних чи рендера без підтвердження відповідями.
## Inventory
Інвентарі, пакетні запити, знімки й локальні ринкові ціни
Необхідний доступ: Inventory / Універсальні
GET /v1/inventory
items[] містить assetid, markethashname, image, prices і currency. Inspect-поля - лише за наявності.
Діє приватність Steam. Порожній публічний і недоступний інвентар - різні стани. Лічильники Rust у Players. Пакети інвентарів оплачуються за кожного запитаного гравця.
Включені методи даних:
- /steam/api/inventory
- /v1/cs2/items
- /v1/inventories
- /v1/inventory
- /v1/inventory-snapshots
- /v1/inventory/refresh-prices
- /v1/items
- /v1/portfolio-history
- /v1/price
- /v1/price-history
- /v1/prices
- /v1/prices/coverage
- /v1/inventory-snapshots/{id}/diff
https://woksteamapi.com/api/integration-guide.md
```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/inventory?steam_id=76561198000000001&game=cs2" \
-H "Authorization: Bearer $WOK_API_KEY"
```
Замініть приклад SteamID чи inspect-посилання своїми даними.