API i integracje

Pobieraj dane o serwerach Minecraft do własnych projektów albo pokaż status serwera na swojej stronie. Bez rejestracji – wystarczy limit zapytań na adres IP.

Dostępne endpointy

GET/api/v1/servers

Lista serwerów w kolejności rankingu głównego (parametry: limit, cursor, online).

GET/api/v1/servers/{slug}/status

Aktualny status pojedynczego serwera: gracze online, wersje, tryby, głosy i Health Score.

GET/api/v1/servers/{slug}/badge.svg

Odznaka SVG ze statusem serwera (parametry: theme=dark|light, metric=status|health).

GET/api/v1/widget/{slug}

Widget HTML do osadzenia w iframe (parametr: theme=dark|light).

Limity i zasady

Anonimowo: 60 zapytań/h dla listy, 120/h dla statusu serwera.
Odznaki i widgety: 600 zapytań/h – wystarcza dla większości stron.
Odpowiedzi są cache'owane przez 30–60 sekund.
Dane możesz publikować, podając CraftSerwery.pl jako źródło.
Klucze API z wyższymi limitami przygotowujemy dla integracji komercyjnych.

Pole `health`

Ocena 0–100 liczona z dostępności, liczby przerw, czasu odpowiedzi sondy i kompletności profilu. Liczba graczy nie jest jej składową. Pole jest null, dopóki serwer nie ma trzech dób pomiarów; odświeżamy je co godzinę. Pełna metodologia.

"health": {
  "score": 92,
  "grade": "EXCELLENT",
  "label": "Wzorowy",
  "updatedAt": "2026-08-19T08:00:00.000Z"
}

Przykład użycia

curl "https://craftserwery.pl/api/v1/servers?limit=5&online=true"

Zobacz odpowiedź

Konfigurator widgetu

Serwer

Podgląd live

Kod embed do wklejenia

<a href="https://craftserwery.pl/serwer/126-survmc-maxc-pl" rel="nofollow">
  <img src="https://craftserwery.pl/api/v1/servers/126-survmc-maxc-pl/badge.svg?theme=dark&metric=status&style=card" alt="Status serwera" height="40">
</a>

Predefiniowane style

Dlaczego warto dodać widget?

Gracze odwiedzający Twoją stronę widzą aktualny status serwera i liczbę graczy, a Ty zyskujesz wiarygodność. Widget nie wymaga żadnych skryptów zewnętrznych i nie spowalnia strony.