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