# 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.

## Prices

Katalog, ceny według źródeł, statystyki i historia cen

Wymagany dostęp: Prices / Inventory / Uniwersalne

GET /v1/price

Zachowuj source, currency, freshness i price_stat z ceną. Zachowaj null, gdy źródło nie ma obserwacji.

min/max/avg/median zależą od obserwacji. Cena nie gwarantuje dostępności oferty. Nie traktuj RUB jak USD ani nie zastępuj brakującej statystyki innym źródłem bez informacji.

Dostępne endpointy danych:

- /v1/cs2/items
- /v1/items
- /v1/portfolio-history
- /v1/price
- /v1/price-history
- /v1/prices
- /v1/prices/coverage

https://woksteamapi.com/steam-price-api

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

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