Skip to main content

1. Podstrony i Endpointy Publiczne — Mapa Drzwi Warsztatu

Źródło: repo afterlife/docs/api/01-publiczne-i-podstrony-rp.md — edytuj w repo, nie tutaj.

Podstrony i Endpointy Publiczne — Mapa Drzwi Warsztatu

Orin z zielonym płomieniem terminala

Wskakuje na obudowę serwera i otrzepuje futro z pyłu! O, witaj wędrowcze! Szukasz wejścia do naszego Warsztatu na ariku.pl, nyah~? Jestem Orin i pilnuję tu wszystkich kabli, wózków i podstron! Zanim zaczniesz stukać w losowe adresy URL, rozłożyłam dla ciebie kompletną mapę wszystkich dwudziestu podstron oraz ośmiu publicznych punktów dostępowych API. Rozgość się, zaraz przejedziemy przez nie wszystkie! macha ogonem

Cała nasza strona działa w czterech głównych trybach na pasku: IT PRO (profesjonalne CV i projekty Majstra), GAMING (nasza społeczność Anvil of Suns, serwery gier, muzyka i Kuźnia), SYSTEM (stan serwerów, sieci i usług dla członków społeczności) oraz PERSONAL (prywatny pulpit Majstra za zamkniętymi Wrotami).

Podstrony widoczne w przeglądarce (20 ścieżek)

Większość klasycznych ścieżek z dawnego portfolio robi dziś sprytny skok (redirect) prosto na stronę główną z odpowiednią kotwicą, a pozostałe to pełnoprawne, osobne ekrany aplikacji! strzyże uszami

Endpoint / Ścieżka Metody Dostęp Opis działania i parametry
/ GET Publiczny / Zależny od trybu Główny ekran aplikacji. Przyjmuje parametry zapytania takie jak ?gaming=1 (przełącza w tryb społeczności Anvil of Suns) albo ?personal=1 (widok właściciela).
/cv GET Publiczny Dedykowana, pełna karta CV Majstra w trybie IT PRO — gotowa do czytania i druku.
/projects GET Publiczny Przekierowanie 307/308 na /#projects (sekcja projektów na stronie głównej).
/skills GET Publiczny Przekierowanie na /#skills (macierz umiejętności technicznych).
/experience GET Publiczny Przekierowanie na /#experience (historia doświadczenia zawodowego).
/services GET Publiczny Przekierowanie na /#services (status publicznie widocznych usług).
/about GET Publiczny Przekierowanie prosto na / (główny widok o autorze).
/blog GET Publiczny Przekierowanie na / (wpisy i kroniki są zintegrowane z głównym widokiem oraz wiki).
/contact GET Publiczny Przekierowanie na / (dane kontaktowe w stopce i nagłówku).
/merch GET Publiczny Kuźnia Koszulek — interaktywny kreator koszulek full-print (9 generatorów wzorów z seeda, tryb EASY, własna grafika, napisy wektorowe i paleta HEX; obecnie w wersji podglądowej przed otwarciem zamówień).
/merch/glosuj GET Publiczny Strona głosowania na kolejne funkcje i rozwój Kuźni Koszulek (do 3 głosów bez logowania, przyjmuje opcjonalny parametr ?src=discord).
/music GET Członkowie Discorda Webowy odtwarzacz i wspólna kolejka muzyczna (biblioteka + YouTube) powiązana ze mną na kanałach głosowych Discorda!
/download GET Publiczny (z pozycjami dla właściciela) Centralna pobieralnia paczek, motywów AnvilTerminal, moda authlogic, instalatorów Lunety i nakładki OBS (obs-pack).
/download/file/[product]/[asset] GET Zależny od produktu Bezpośredni strumień pobierania pliku binarnego dla wybranego produktu ([product]) i zasobu ([asset]).
/luneta GET Publiczny (pobieranie) / Discord OAuth (panel) Strona narzędzia Luneta — publiczne pobieranie instalatora, regulamin i licencja MIT, a po zalogowaniu przez Discord panel gracza (urządzenia, postępy, waluty, kody i analiza nagrań).
/luneta/download/[file] GET Publiczny Pobieranie instalatora, pakietu aktualizacyjnego lub sum kontrolnych SHA256SUMS agenta desktopowego Lunety ([file]).
/radar GET Publiczny Tablica Radaru — przegląd premier gier, darmowych gier do odebrania, promocji, wydarzeń i kodów z filtrami i osią czasu.
/radar.ics GET Publiczny Strumień kalendarza iCalendar (text/calendar) z nadchodzącymi premierami i darmowymi grami z Radaru — do subskrypcji w kalendarzu!
/co-robimy GET Tylko Majster (Owner) Prywatny ekran decyzyjny „Co robimy?” — plan dnia, wskaźnik Chaos Meter, zadania stałe i poziom Majstra.
/dashboard GET Publiczny (placeholder) Ścieżka zarezerwowana pod osobny widok dashboardu (Dashboard coming soon — aktywne panele telemetrii działają bezpośrednio w zakładkach IT PRO, GAMING, SYSTEM i PERSONAL na /).

Publiczne i półpubliczne endpointy API (8 ścieżek)

Te punkty końcowe zasilają wykresy, mapę świata w trybie IT PRO oraz publiczne liczniki. Żaden z nich nie zdradza prywatnych nazw graczy ani wewnętrznych adresów serwerowni — wszystko jest dokładnie przefiltrowane! przekrzywia głowę

Endpoint Metody Dostęp Opis działania i parametry
/api/monitoring GET Publiczny Zwraca zagregowany status zdrowia usług homelabu i kontenerów bez ujawniania wrażliwych danych wewnętrznych.
/api/map GET Publiczny Zasila interaktywną mapę świata Anvil of Suns ([Map]). Zwraca lokacje z kanonu oraz publiczny stan krain: Ironloom (Factorio), Ymirel (Enshrouded) i Nidarel (Minecraft ATM10).
/api/playwright-stats GET Publiczny Zwraca statystyki naszego Hartowania (testów E2E Playwright) — ile testów przeszło, ile trwa na żywo i jaki jest wynik ostatniego przebiegu.
/api/merch/poll GET, POST Publiczny (GET), Zalogowani (POST) Obsługa ankiety merchowej. GET zwraca aktualne wyniki z sieci i Discorda; POST zapisuje głos użytkownika na wybrany projekt.
/api/stats/event POST Publiczny Lekki kolektor anonimowych zdarzeń analitycznych na stronie (np. kliknięcia w sekcje, przełączenia trybów).
/api/obs-pack/manifest GET Publiczny / Klucz paczki Zwraca manifest wersji i listę plików dla paczki nakładek OBS.
/api/obs-pack/status GET, POST Klucz paczki / Zalogowani Raportuje i odczytuje status synchronizacji nakładek OBS u twórców.
/api/orin/poll GET, POST Wewnętrzny klucz bota / Sesja Punkt wymiany szybkich pytań i ankiet obsługiwanych przeze mnie między stroną a serwerem Discord.

Jak działa publiczna Mapa Świata (/api/map)?

To jeden z moich ulubionych kawałków kodu, nyah~! Kiedy klikasz [Map] w nawigacji, przeglądarka pyta /api/map o stan naszych krain. Żeby nikt z zewnątrz nie zamęczył serwerów gier, endpoint nigdy nie otwiera bezpośredniego połączenia RCON przy każdym wejściu na stronę! Zamiast tego czyta świeżą migawkę (state_snapshot) z bazy Kroniki, którą wewnętrzne zegary aktualizują co 2 minuty:

  1. Ironloom (// factorio server) — pokazuje odkryte planety (Nauvis, Vulcanus, Fulgora, Gleba, Aquilo), procent ukończonych badań na każdej z nich, aktualnie badaną technologię oraz wskaźnik zagrożenia (spokojnie, ostrzegawcze, wysokie).
  2. Ymirel (// enshrouded server) — zwraca informację, czy mroźna kraina odpowiada i ilu wędrowców aktualnie przemierza mgłę.
  3. Nidarel (// atm10 server) — sprawdza, czy podziemne kuźnie dzwonią i ilu kopaczy siedzi pod ziemią.

Ze względów prywatności /api/map zwraca wyłącznie liczbę graczy online (playersOnline), nigdy ich prawdziwe pseudonimy!

Na tej pierwszej stronie naszej księgi spisałam dla ciebie dokładnie 28 ścieżek (20 podstron i 8 endpointów API). Zeskakuje z obudowy serwera, zawija ogon wokół łapek i mruga z uśmiechem!

No comments to display