NORE OpenAPI

API Nore bez klucza

Najnowsza wersja 1.4 Synchronizacja w tle co 15 min Odpowiada Ci Cloudflare

Wydania, aktualizacje launchera i moda, wydarzenia i obsługiwane wersje. JSON, otwarty CORS i odpowiedzi z ETag. Wołają je launcher, mod i ta strona.

Wyślij pierwsze zapytanie

Zapytaj na żywo

Wybierz endpoint i parametry. Odpowiedź przychodzi prosto z noroclient.pl, razem z nagłówkami.

GET /api/v1/version
— — ms cache — ETag —
Wybierz endpoint po prawej.
Otwórz w nowej karcie
Endpoint

Każda zmiana wysyła zapytanie od razu. To samo działa z curl https://noroclient.pl/api/v1/version.

Wszystkie adresy

Lista w JSON
/updates/launcher w praktyce: Nore Updater pyta o nową wersję przy każdym starcie launchera i sprawdza SHA-256 pobranego pliku.

Zapytanie trafia na krawędź

Odpowiada serwer Cloudflare najbliżej Ciebie, nie jeden komputer gdzieś daleko.

Odpowiedź /api/v1/version
  1. Krawędź
  2. Pamięć
  3. Odświeżanie
  4. Cron

Te dane widzisz w grze

Menu główne Nore Client z wiśniowym stawem w tle i kartą „Nowe w 1.4 Beta”
Menu główne moda: aktualności i wydarzenia.
Ekran główny Nore Launcher z kartą wydarzenia „Święta w Nore” i odliczaniem
/events: zimowy motyw włącza się sam 10 grudnia.
Nore Updater po aktualizacji: zielony pierścień i napis Zaktualizowano!
Po aktualizacji Updater wita nową wersję.
Nowe radialne menu Nore: kategorie w wewnętrznym pierścieniu i moduły kategorii Gracz na zewnętrznym
Nowe radialne menu, wersja z /version.

Zanim zapytasz

Czy potrzebuję klucza?

Nie. Każdy endpoint jest publiczny i działa bez rejestracji. Prosimy tylko, żeby jeden program nie pytał częściej niż co minutę. Dane i tak zmieniają się co kilka minut.

Mogę wołać API z przeglądarki?

Tak. Odpowiedzi mają Access-Control-Allow-Origin: *, więc fetch() działa z każdej strony, także z Twojej.

Jak świeże są dane?

Co 15 minut Cron Trigger pobiera wydania z GitHuba w tle. Między synchronizacjami odpowiedź przychodzi z pamięci, a starsza niż 5 minut odświeża się w tle przy pierwszym zapytaniu.

Co znaczy X-Nore-Cache?

HIT to świeże dane z pamięci. STALE to starsze dane podane od razu, które w tle właśnie się odświeżają. MISS to pierwsze zapytanie, z danymi pobranymi na żywo.

Jak oszczędzać transfer?

Zapisz nagłówek ETag i wyślij go następnym razem w If-None-Match. Jeśli nic się nie zmieniło, dostaniesz pustą odpowiedź 304.

Skąd są pliki do pobrania?

Z GitHub Releases repozytorium kondzio444/Noreclienr. API podaje adres, rozmiar i SHA-256, a /download przekierowuje prosto do pliku.

Czy API się zmieni?

Adresy /api/v1 zostają. Nowe pola mogą dochodzić, ale żadne nie znika ani nie zmienia znaczenia. Zmiana, która coś psuje, dostałaby nowe /api/v2.

Czy jest Forge?

Parametr loader w /updates/mod przyjmuje fabric albo forge. Lista z /platforms mówi, co jest dostępne dla danej wersji.