WOK API

Prices API - Comment se connecter | WOK

Catalogue, prix par source, statistiques et historique

Accès requis

Prices / Inventory / Généralistes

Choisir un forfait

1. Créer une clé
Connectez-vous et choisissez le forfait adapté.
2. Configurer l’environnement serveur
WOK_API_KEY est votre clé WOK, pas Steam. Ne la mettez pas dans le navigateur, les URL, les journaux ou les consignes aux agents.
3. Vérifier l’accès et envoyer une requête
GET /v1/key renvoie les endpoints et limites autorisés sans consommer d’unités.

Compte →

Première requête

Remplacez le SteamID ou lien d’exemple par vos données.

cURL

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"

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/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true", {
  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/price?game=rust&name=Big+Grin&price_source=tm&price_stat=min&strict=true'
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.

Traiter la réponse

Conservez source, currency, freshness et price_stat avec le prix. Gardez null sans observation de la source.

min/max/avg/median dépendent des observations. Un prix ne garantit pas la disponibilité d’une annonce. Ne traitez pas RUB comme USD et ne remplacez pas silencieusement une statistique absente par une autre source.

Paramètres et format de réponse →

Guide pour agents

Copiez la tâche dans votre outil. Définissez la clé séparément sur le serveur ; les instructions n’en contiennent pas.

Markdown OpenAPI

Lire les instructions

# Se connecter à WOK API

WOK_API_KEY est votre clé WOK, pas Steam. Ne la mettez pas dans le navigateur, les URL, les journaux ou les consignes aux agents.

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. Examinez la stack et créez un adaptateur serveur selon les conventions du projet.

2. Appelez GET /v1/key une fois pour vérifier gratuitement access.endpoints, capabilities et quotas. Les forfaits spécialisés excluent les autres usages.

3. Utilisez les paramètres documentés et vérifiez les états HTTP et applicatifs. Distinguez unavailable, private et empty. Les données absentes restent null ou unavailable, jamais des zéros inventés.

4. Fixez une échéance totale de 60 secondes et limitez la concurrence. Réessayez les 429/502/503/504 temporaires deux fois maximum avec délai aléatoire, en respectant Retry-After et l’échéance. Quota épuisé : attendre le reset. Aucune boucle sur 400/401/403 ou fonctions non prises en charge.

5. Mettez en cache selon les dates des sources et regroupez les lectures identiques en cours. Pas de requête par image d’animation ni d’actualisation forcée automatique.

6. Conservez devise, source, statistique et date ensemble. Ne comparez pas différentes devises ou observations comme un même prix.

7. Utilisez SteamID64 en chaînes, pas en nombres JavaScript. Encodez les noms dans l’URL en préservant espaces, ★, barres et caractères non latins. Suivez la pagination par curseur. Les lots peuvent coûter par objet ou joueur.

8. Créez d’abord exemples et vérifications avec des mocks. Demandez avant des requêtes réelles payantes ou massives. Ce texte n’autorise ni achats, changements de forfait, prélèvements ni e-mails.

9. Indiquez fichiers modifiés, commandes, vérifications et fonctions non prises en charge. N’affirmez pas d’équivalence de données ou rendu sans preuve dans les réponses.

## Prices

Catalogue, prix par source, statistiques et historique

Accès requis: Prices / Inventory / Généralistes

GET /v1/price

Conservez source, currency, freshness et price_stat avec le prix. Gardez null sans observation de la source.

min/max/avg/median dépendent des observations. Un prix ne garantit pas la disponibilité d’une annonce. Ne traitez pas RUB comme USD et ne remplacez pas silencieusement une statistique absente par une autre source.

Endpoints de données inclus:

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

Remplacez le SteamID ou lien d’exemple par vos données.

← Autres usages