API da WARDOGS IBERIA

Como começar

1. Entra no site com a tua conta Steam.
2. Em Perfil → Chaves de API, cria uma chave. O segredo aparece uma só vez: guarda-o.
3. Envia a chave no cabeçalho X-API-Key em cada pedido.

Autenticação

Todos os pedidos levam o cabeçalho X-API-Key. Uma chave revogada deixa de funcionar de imediato. Nunca partilhes a chave nem a ponhas em código público.

Endereço base: https://wardogsiberia.eu/api/v1

curl -H "X-API-Key: <API_KEY>" https://wardogsiberia.eu/api/v1/servers/live

Limites

Por defeito: 100 pedidos por dia (recomeça às 00:00 UTC) e 30 por minuto, por pessoa. Os teus limites atuais aparecem em Perfil → Chaves de API.

Cada resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset (dia) e X-RateLimit-Minute-Limit e X-RateLimit-Minute-Remaining (minuto). Com o limite esgotado recebes 429 e Retry-After em segundos.

Rotas disponíveis (GET)

Só estas rotas respondem pela API. Tudo o resto (admin, contas, dados privados) não está disponível.

• GET /v1/serversLista de servidores da comunidade.
• GET /v1/servers/liveEstado ao vivo de todos os servidores (jogadores, mapa, pontuação).
• GET /v1/servers/{id}Um servidor.
• GET /v1/servers/{id}/liveEstado ao vivo de um servidor.
• GET /v1/players/by-handle/{handle}Perfil público por slug, SteamID64 ou nickname.
• GET /v1/players/leaderboardRanking de jogadores do site.
• GET /v1/players/{id}/game-statsDados de jogo guardados de um jogador (horas, nível, conquistas).
• GET /v1/game-stats/leaderboardRanking da comunidade (nível, XP, horas).
• GET /v1/tracker/leaderboardRanking com dados do WARDOGS Tracker guardados por nós.
• GET /v1/tracker/servers/{id}/leaderboardRanking de um servidor com dados do WARDOGS Tracker.
• GET /v1/squadsLista de squads.
• GET /v1/squads/{id}Uma squad.
• GET /v1/eventsLista de eventos.
• GET /v1/events/{id}Um evento.
• GET /v1/intelligence/overviewResumo agregado da atividade.
• GET /v1/lfg/partiesParties LFG abertas.

Erros

• 401 API_KEY_INVALID: Chave em falta, errada ou revogada.
• 404 API_ROUTE_NOT_FOUND: Rota fora da lista acima.
• 429 API_RATE_LIMITED: Demasiados pedidos neste minuto.
• 429 API_QUOTA_EXCEEDED: Quota diária esgotada (recomeça às 00:00 UTC).
• 503 API_UNAVAILABLE: API temporariamente indisponível. Tenta mais tarde.

Regras de uso

• Só dados públicos: nada que um visitante não veja no site.
• Faz cache do lado do teu programa; não peças o mesmo segundo a segundo.
• Diz de onde vêm os dados (WARDOGS IBERIA) quando os mostrares.
• Uso abusivo leva à revogação da chave.