# Połącz z WOK API

WOK_API_KEY to klucz WOK, nie Steam. Nie umieszczaj go w kodzie przeglądarki, URL, logach ani poleceniach agenta.

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. Sprawdź stos projektu i utwórz adapter serwerowy zgodnie z jego konwencjami.

2. Wywołaj raz GET /v1/key, aby bezpłatnie sprawdzić access.endpoints, capabilities i limity. Plany specjalistyczne nie obejmują innych obszarów.

3. Użyj udokumentowanych parametrów i sprawdzaj HTTP oraz status aplikacji. Rozróżniaj unavailable, private i empty. Brak danych to null lub unavailable, nie wymyślone zera.

4. Ustaw łączny limit 60 sekund i ogranicz równoległość. Przejściowe 429/502/503/504 ponawiaj najwyżej dwa razy z losowym opóźnieniem, respektując Retry-After i limit czasu. Po wyczerpaniu kwoty czekaj na reset. Nie zapętlaj 400/401/403 ani nieobsługiwanych funkcji.

5. Buforuj według czasu źródła i łącz identyczne trwające odczyty. Nie odpytuj co klatkę ani nie wymuszaj automatycznego odświeżania.

6. Zachowuj razem walutę, źródło ceny, statystykę i czas obserwacji. Nie porównuj różnych walut i migawek źródeł jak tej samej ceny.

7. Używaj SteamID64 jako ciągów, nie liczb JavaScript. Koduj nazwy w URL, zachowując spacje, ★, pionowe kreski i znaki niełacińskie. Stosuj paginację kursorem. Pakiety mogą być rozliczane za przedmiot lub gracza.

8. Najpierw utwórz przykłady i sprawdzenia z mockami. Zapytaj przed płatnymi rzeczywistymi lub masowymi żądaniami. Instrukcja nie zezwala na zakupy, zmianę planów, obciążenia ani e-maile.

9. Podaj zmienione pliki, polecenia, sprawdzenia i nieobsługiwane funkcje. Nie deklaruj zgodności danych lub renderowania bez potwierdzenia odpowiedziami.

## Assets

Beta: wyszukiwanie przedmiotów CS2 w zaobserwowanych publicznych ekwipunkach

Wymagany dostęp: Assets / Uniwersalne

GET /v1/cs2/assets

items[] zawiera assetid, observed_owner_steamid, markethashname, nullable float_value/paint_seed/def_index, obrazy i obserwacje. GET /v1/cs2/assets/coverage podaje zakres. POST /v1/cs2/assets/find przyjmuje queries[] do 50 filtrów, jednostka za zapytanie.

Beta wcześniej pobranych publicznych ekwipunków: do 100 tys. przedmiotów przez 7 dni, 5 tys. na ekwipunek. Bez aktywnego skanowania, prywatnych ekwipunków/nakładki wymian i pełnej historii właścicieli/przekazań. Float/seed nie dowodzi unikalności. Pusty wynik oznacza brak obserwacji. Find zwraca do 20 kandydatów; kontynuuj z next_cursor w GET /v1/cs2/assets.

Dostępne endpointy danych:

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

Zastąp przykładowy SteamID lub link własnymi danymi.