WOK API

Players API - Cómo conectar | WOK

Perfiles Steam, amigos, alias, estadísticas y FACEIT

Acceso necesario

Players / Uso general

Elegir plan

1. Crea una clave
Inicia sesión y elige un plan adecuado.
2. Configura el entorno del servidor
WOK_API_KEY es tu clave WOK, no de Steam. No la pongas en código del navegador, URL, registros ni instrucciones para agentes.
3. Comprueba el acceso y haz una solicitud
GET /v1/key muestra endpoints y límites sin consumir unidades.

Cuenta →

Primera solicitud

Sustituye el SteamID o enlace de ejemplo por tus datos.

cURL

curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/rust/summary?steam_id=76561198000000001" \
  -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/rust/summary?steam_id=76561198000000001", {
  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/rust/summary?steam_id=76561198000000001'
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.

Procesar la respuesta

kills, resources, combat, stats_by_name. No inventes contadores ausentes. Usa /v1/rust/playtime para horas y /v1/rust/achievements para logros.

Los contadores Rust son observaciones acumuladas de la cuenta Steam, no por servidor. Amigos, nivel, alias y juegos tienen rutas separadas. Los perfiles privados pueden ocultar esos datos.

Parámetros y formato de respuesta →

Guía para agentes

Copia la tarea en tu herramienta. Configura la clave aparte en el servidor; la instrucción no contiene claves.

Markdown OpenAPI

Leer instrucciones

# Conecta con WOK API

WOK_API_KEY es tu clave WOK, no de Steam. No la pongas en código del navegador, URL, registros ni instrucciones para agentes.

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. Revisa el stack y crea un adaptador del servidor siguiendo las convenciones del proyecto.

2. Llama una vez a GET /v1/key para revisar access.endpoints, capabilities y cuotas, sin coste. Los planes específicos excluyen otras tareas.

3. Usa parámetros documentados y valida HTTP y estado de aplicación. Distingue unavailable, private y empty. Los datos ausentes siguen null o unavailable; nunca inventes ceros.

4. Fija un plazo total de 60 segundos y limita concurrencia. Reintenta 429/502/503/504 temporales como máximo dos veces con variación aleatoria, respetando Retry-After y el plazo. Si se agota la cuota, espera el reinicio. No repitas en bucle 400/401/403 ni funciones no admitidas.

5. Cachea según la fecha de la fuente y une lecturas idénticas en curso. No consultes por fotograma ni fuerces actualizaciones automáticas.

6. Conserva moneda, fuente, estadística y fecha juntas. No compares monedas o instantáneas distintas como un mismo precio.

7. Usa SteamID64 como cadenas, no números JavaScript. Codifica nombres en URL conservando espacios, ★, barras y caracteres no latinos. Sigue la paginación por cursor. Los lotes pueden cobrar por objeto o jugador.

8. Crea ejemplos y pruebas con mocks primero. Pide permiso antes de solicitudes reales pagadas o masivas. Esta instrucción no autoriza compras, cambios de plan, cobros ni correos.

9. Informa de archivos, comandos, pruebas y funciones no admitidas. No afirmes equivalencia de datos o render sin respaldo en las respuestas.

## Players

Perfiles Steam, amigos, alias, estadísticas y FACEIT

Acceso necesario: Players / Uso general

GET /v1/rust/summary

kills, resources, combat, stats_by_name. No inventes contadores ausentes. Usa /v1/rust/playtime para horas y /v1/rust/achievements para logros.

Los contadores Rust son observaciones acumuladas de la cuenta Steam, no por servidor. Amigos, nivel, alias y juegos tienen rutas separadas. Los perfiles privados pueden ocultar esos datos.

Endpoints de datos incluidos:

- /steam/api/profile
- /steam/api/profile/games
- /v1/aliases
- /v1/friends
- /v1/games
- /v1/games/achievements
- /v1/player-security
- /v1/profile
- /v1/profiles
- /v1/rust/achievements
- /v1/rust/playtime
- /v1/rust/stats
- /v1/rust/summary
- /v1/steam-level
- /faceit/data/v4/players
- /faceit/data/v4/players/{id}/stats/{game}
- /faceit/data/v4/players/{id}/history

https://woksteamapi.com/rust-player-stats-api

```sh
curl --fail-with-body --max-time 60 "https://woksteamapi.com/v1/rust/summary?steam_id=76561198000000001" \
  -H "Authorization: Bearer $WOK_API_KEY"
```

Sustituye el SteamID o enlace de ejemplo por tus datos.

← Otras tareas