API
Palvelimesi dataomissa työkaluissasi.
Vain luku -API Premium-palvelimille: ketkä ovat paikalla, matsi, pelaajat, tapot ja historia. Avaimet luodaan kohdassa WARPANEL → Asetukset → API.
Endpointit · warpanel.gg/api/v1Vain luku
GET/v1/serversPalvelimesi juuri nyt (palvelinselain)
GET/v1/serverPalvelin juuri nyt
GET/v1/playersPelaajat ja heidän tilastonsa (tulostaulut)
GET/v1/players/{steamId}Yksi pelaaja
GET/v1/matchesViimeisimmät matsit
GET/v1/eventsTapahtumasyöte (tapot ja matsien tulokset)
GET/v1/weaponsAseet
GET/v1/mapsKartat
GET/v1/totalsKokonaismäärät (tänään, kausi, kaikki ajat)
GET/v1/historyHistoria ja vilkkaimmat tunnit
~❯curl -H "Authorization: Bearer $WARPANEL_API_KEY" https://warpanel.gg/api/v1/server
{
"server": {
"id": "x7k2p9",
"name": "[DOGS] Dog House EU | KOTK",
"joinCode": "ABCD1234",
"region": "eu-central",
"source": "rcon"
},
"online": true,
"players": {
"current": 58,
"max": 100
},
"match": {
"map": "Bakurani",
"lighting": "Day",
~❯
Miten se toimii
- 01Vain luku -JSONia HTTPS:n yli. Perus-URL: https://warpanel.gg/api/v1
- 02Tunnistautuminen: lähetä avain muodossa
Authorization: Bearer wpk_…(taiX-API-Key: wpk_…). Palvelimen omistaja luo avaimet kohdassa WARPANEL → Asetukset → API. Palvelinavain lukee yhtä palvelinta; verkkoavain (vain omistaja) lukee jokaista palvelinta, joka omistajalla on WARPANELissa. - 03Verkkoavaimet valitsevat palvelimen parametrilla ?server=<id> (id:t saa GET /servers -kutsusta; myös slug tai liittymiskoodi käy) tai ?server=all, joka yhdistää palvelimet (pelaajat yhdistetään Steam ID:n mukaan). Ilman ?server-parametria yhdistämistä tukevat endpointit yhdistävät (all), ja /server pyytää yhden. Palvelinavaimella ?server voi jättää pois.
- 04Vain Premium-palvelimille. Avain lakkaa vastaamasta (403 premium_required), kun palvelin, jolle se luotiin, on Free-tasolla.
- 0560 pyyntöä minuutissa avainta kohden. Otsakkeet: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (sekunteina). Rajan ylittyessä: 429 ja Retry-After.
- 06Meidän päässämme live-data välimuistetaan 10 sekunniksi, tapahtumasyöte 5 sekunniksi, tilastot 1–2 minuutiksi ja historia 10 minuutiksi, joten tiheämmästä kyselystä ei ole hyötyä. Välimuistita myös omassa päässäsi (30–60 s riittää hyvin nettisivuille).
- 07Ajat ovat ISO 8601 -muodossa UTC-ajassa. /totals ja /history ottavat parametrin ?tz= (IANA-aikavyöhyke kuten Europe/Berlin) ”tänään”-arvoa ja vilkkaimpia tunteja varten. Steam ID:t ovat 17-numeroisia SteamID64-merkkijonoja. Tiimit ovat Valkyra (punainen), Lonestar (sininen) ja Manticore (vihreä); palvelimelle mahtuu enintään 100 pelaajaa.
- 08Pelaajat, jotka ovat piilottaneet itsensä tulostauluilta, jätetään pois pelaajalistoista; muualla (live-lista, matsit, tapahtumat) he näkyvät nimellä ”Piilotettu pelaaja” ja steamId on null.
- 09CORS on auki GET-pyynnöille, mutta pidä avain palvelimella (backend-reitti, serverless-funktio tai Cloudflare Worker) — kaiken selaimen JavaScriptissä olevan voi lukea jokainen kävijä.