API · MCDC

Zanim zaczniesz

Adres podstawowy: https://mcdc.pl
Skąd te dane: z kopii odświeżanej co 30 minut. Odpytywanie częściej nie da świeższych liczb.
Wyjątek: /api/status liczy się na bieżąco.
Kodowanie: zawsze UTF-8, zawsze application/json.
Błędy: kod HTTP plus pole ok w treści. Nieznana kategoria dostaje 404 i listę tych, które istnieją.

GET

/api/status

cache: 20 sekund

Ilu graczy jest w sieci i ile serwerów działa. Jedyna końcówka liczona na bieżąco.

{"ok":true,"online":3,"up":2,"servers":2}

curl https://mcdc.pl/api/status

GET

/api/gracze

cache: jak migawka

Podpowiedzi do wyszukiwarki. Dopasowanie po początku nicku.

q wymagany początek nicku, co najmniej dwa znaki

{"players":[{"name":"Demciak","last_seen":1788000624}]}

curl https://mcdc.pl/api/gracze

GET

/api/ranking/{kategoria}

cache: jak migawka

Jedno zestawienie. Nieznana kategoria zwraca 404 z listą dostępnych.

`kategoria`	w adresie	identyfikator zestawienia albo umiejętności
`limit`	opcjonalny	od 1 do 100, domyślnie 10
`okres`	opcjonalny	„month" zawęża do bieżącego miesiąca tam, gdzie ma to sens

{"ok":true,"kategoria":"kasa","nazwa":"Najbogatsi","okres":"all",
 "jednostka":"Monety","pozycje":[{"miejsce":1,"nazwa":"Patrudka",
  "wartosc":45030,"formatted":"45 030,00","profil":"…/gracz/Patrudka"}]}

curl https://mcdc.pl/api/ranking/kasa

GET

/api/zdrowie

cache: brak

Stan serwisu dla monitoringu. 200 znaczy, że dane są świeże, 503 że nie. Bazy gry nie dotyka, chyba że o to poprosisz.

baza opcjonalny dowolna wartość włącza pomiar czasu odpowiedzi bazy gry

{"ok":true,"stan":"ok","migawka":{"wiek_sekund":312,"zestawow":95,
 "bledow":0},"bledy":{"ostatnia_godzina":0,"ostatnia_doba":0}}

curl https://mcdc.pl/api/zdrowie

GET

/sitemap.xml

cache: godzina

Mapa strony dla wyszukiwarek.

<urlset><url><loc>https://mcdc.pl/</loc>…</url></urlset>

curl https://mcdc.pl/sitemap.xml

Identyfikatory zestawień

28

Do wstawienia w miejsce {kategoria}.

kasa umiejetnosci czas skoki potwory gracze obrazenia oberwane smierci dystans bieg lot plywanie spadanie gildie wyspy dungeony

Umiejętności:

gornictwo drwal rolnictwo rybactwo wykopaliska alchemia zaklinanie walka lucznictwo obrona zwinnosc

Czego tu nie ma

Końcówek zapisujących. Przez API nie zmienisz niczego w grze. Nie ma tu też adresów IP, adresów e-mail ani żadnych danych osobowych.

Brakuje Ci czegoś? Napisz na Discordzie.