Dokumentacja API serwerów gier

Adres i uwierzytelnianie

Adres API: https://newplay.pl/APIGame/. Każde żądanie musi zawierać klucz w nagłówku HTTP. Klucz utworzysz i unieważnisz w Koncie → Klucze API.

Authorization: Bearer np_live_TWOJ_KLUCZ
Accept: application/json

Nie wysyłaj klucza w adresie URL ani w kodzie publicznej strony. Wymagane jest HTTPS.

Lista serwerów

GET /APIGame/?action=servers.list

curl --request GET \
  --url 'https://newplay.pl/APIGame/?action=servers.list' \
  --header 'Authorization: Bearer np_live_TWOJ_KLUCZ' \
  --header 'Accept: application/json'

Odpowiedź zawiera serwery gier przypisane do konta: kod serwera, grę, stan, liczbę graczy, port, mapę, nazwę i termin wygaśnięcia.

{
  "ok": true,
  "count": 1,
  "servers": [{
    "server": "A1B2C",
    "game": {"name": "Counter-Strike 1.6", "slug": "cs-16"},
    "status": "online",
    "status_label": "Włączony",
    "players": {"current": 10, "max": 20},
    "port": 27015,
    "addresses": {
      "ip": "1.2.3.4:27015",
      "domain": "s1.newplay.pl:27015"
    },
    "expires_at": "2026-12-01T12:00:00+00:00",
    "expires_in_seconds": 86400,
    "map": "de_dust2",
    "map_url": "https://newplay.pl/assets/maps/cs16/de_dust2.jpg",
    "hostname": "Counter-Strike 1.6 @ NewPlay.pl"
  }],
  "generated_at": "2026-11-02T12:00:00+00:00"
}

Uruchomienie i zatrzymanie

Użyj metody POST z treścią JSON. W polu server podaj pięcioznakowy kod z panelu.

curl --request POST \
  --url 'https://newplay.pl/APIGame/' \
  --header 'Authorization: Bearer np_live_TWOJ_KLUCZ' \
  --header 'Content-Type: application/json' \
  --data '{"action":"servers.start","server":"A1B2C"}'

Do zatrzymania ustaw action na servers.stop. Odpowiedź 202 Accepted oznacza, że nod przyjął zadanie. Odczytaj stan ponownie przez servers.list.

Statusy i błędy

• online — serwer działa; liczba graczy może być chwilowo null, jeśli gra nie odpowiada na zapytanie. W tym stanie zwracane są też map i map_url.
• offline — serwer jest zatrzymany; suspended — usługa zawieszona; expired — okres wygasł.
• Adresy połączenia są zwracane w addresses.ip i addresses.domain, oba zawierają port.
• preparing, payment_pending, failed — przygotowanie, oczekiwanie na płatność albo błąd.
• starting, stopping, restarting, reinstalling, deleting — trwa operacja; unknown — chwilowy brak odczytu noda.

Kody HTTP: 401 błędny klucz, 404 serwer nie należy do konta, 409 serwer nieaktywny lub nieopłacony, 422 błędne dane, 502 niedostępny node.

Zakres uprawnień klucza

• Odczyt danych serwerów gier należących do Twojego konta.
• Start i stop aktywnego, opłaconego serwera.
• Brak dostępu do zmiany konfiguracji, reinstalacji i usuwania serwerów.
• Klucz jest przechowywany jako skrót i pokazywany tylko raz. Po zgubieniu utwórz nowy.
• Unieważnienie blokuje kolejne żądania z użyciem tego klucza.

Przykład klienta PHP

Pobierz archiwum zawierające gotowy skrypt PHP i krótką instrukcję. Przykład korzysta z wbudowanego klienta HTTP PHP, bez dodatkowych bibliotek.