Utworzenie API fCraft.pl - Wersja do druku

+- fCraft.pl (https://fcraft.pl)
+-- Dział: Rozwój (https://fcraft.pl/forumdisplay.php?fid=56)
+--- Dział: API - społeczność programuje serwer (https://fcraft.pl/forumdisplay.php?fid=62)
+---- Dział: Dokumentacja (https://fcraft.pl/forumdisplay.php?fid=53)
+---- Wątek: Utworzenie API fCraft.pl (/showthread.php?tid=907)

Strony: 1 2

Utworzenie API fCraft.pl - Libter - 06.07.2017

W dniu dzisiejszym zostało utworzone oficjalne API serwera fCraft.pl dostępne pod adresem https://api.fcraft.pl/ - zapraszam do tworzenia stron internetowych i aplikacji w oparciu o nie. Dokumentacja poszczególnych zapytań będzie znajdować się w tym dziale, dostępne {server}y to hard - fCraft.pl oraz easy - easy.fCraft.pl.

W tym wątku można również zgłaszać własne propozycje dotyczące zmian w istniejących zapytaniach lub dodania nowych.

RE: Utworzenie API fCraft.pl - Norbi - 07.07.2017

Proponuję dodać możliwość sprawdzania aktualnych cuboidów oraz żeby była gdzieś ich pełna lista.

RE: Utworzenie API fCraft.pl - Libter - 07.07.2017

(07.07.2017, 09:41)Norbi napisał(a): Proponuję dodać możliwość sprawdzania aktualnych cuboidów oraz żeby była gdzieś ich pełna lista.
Pełna lista cuboidów daje spore pole do nadużyć, nieprzypadkowo każdy na serwerze ma dostęp tylko do swoich.

RE: Utworzenie API fCraft.pl - Spitfirex86 - 07.07.2017

Moje propozycje:
  • Lista cuboidów z możliwością wyświetlenia wszystkich cuboidów danego gracza (z podziałem posiadacz/mieszkaniec) oraz informacji o danym cuboidzie,
  • Informacje o graczu: czy jest aktywny, czy posiada premium, oraz jego statystyki jeśli je udostępnia.


RE: Utworzenie API fCraft.pl - Libter - 07.07.2017

(07.07.2017, 09:51)Spitfirex86 napisał(a): Lista cuboidów z możliwością wyświetlenia wszystkich cuboidów danego gracza
Jak wyżej - API nie może udostępniać więcej informacji niż podaje serwer, chyba że do dostępu byłby wymagany klucz wygenerowany dla danego gracza.

RE: Utworzenie API fCraft.pl - boleknowak - 07.07.2017

Informacje o danym użytkowniku, np. ilość wiadomości na czacie + dodac opcje upubliczniania takich statystyk (tak jak to napisał Spitfirex86)
Piszę to mimo faktu, że jest tam wyżej, bo nie jest tam tak sprecyzowane, a po powstaniu api napisałem do Libtera o właśnie tą prooozycje.

RE: Utworzenie API fCraft.pl - Spitfirex86 - 07.07.2017

(07.07.2017, 10:03)boleknowak napisał(a): Informacje o danym użytkowniku, np. ilość wiadomości na czacie + dodac opcje upubliczniania takich statystyk (tak jak to napisał Spitfirex86)
Piszę to mimo faktu, że jest tam wyżej, bo nie jest tam tak sprecyzowane, a po powstaniu api napisałem do Libtera o właśnie tą prooozycje.

Upublicznianie statystyk już jest, /ustaw statystyki

RE: Utworzenie API fCraft.pl - sopher - 08.07.2017

/{serwer}/cuboid/active/{nazwa} - informacja zwrotna nt. cuboidu o podanej nazwie
/{serwer}/player/{nazwa} - informacja zwrotna nt. statystyk (oraz wszelakich informacji) o graczu - część wyświetlana tylko w przypadku, gdy podany gracz ma publicznie udostępnione statystyki (/ustaw statystyki)

RE: Utworzenie API fCraft.pl - Libter - 08.07.2017

Małe podsumowanie co zostanie dodane:
  • Komenda /api - wyświetlająca klucz publiczny (w celu dostępu do danych) i prywatny (na przyszłość w celu modyfikacji danych - np. wysłania przelewu) oraz pozwalająca na wygenerowanie nowych kluczy.
  • /{serwer}/cuboid/{świat}/{nazwa} - dane o istniejących cuboidach.
  • /{serwer}/player/{nick}/cuboids - lista cuboidów gracza, wymagana autoryzacja kluczem publicznym.
  • /{serwer}/player/{nick}/statistics - lista statystyk gracza, wymagana autoryzacja kluczem publicznym (lub bez autoryzacji w przypadku udostępniania).


RE: Utworzenie API fCraft.pl - JanekJaran - 12.07.2017

Proponuję dodać klucz moderacyjny i /{serwer}/mod/} - wyświetlanie aktywnych zgłoszeń wraz z ich ilością.

RE: Utworzenie API fCraft.pl - Spitfirex86 - 12.07.2017

Proponuję dodać stan konta oraz historię transakcji - /{serwer}/account/

RE: Utworzenie API fCraft.pl - JanekJaran - 21.07.2017

składam zapotrzebowanie na:
(08.07.2017, 14:50)Libter napisał(a): /{serwer}/cuboid/{świat}/{nazwa} - dane o istniejących cuboidach.
w związku z tym postem.

RE: Utworzenie API fCraft.pl - Libter - 21.07.2017

(21.07.2017, 11:51)JanekJaran napisał(a): składam zapotrzebowanie na:
(08.07.2017, 14:50)Libter napisał(a): /{serwer}/cuboid/{świat}/{nazwa} - dane o istniejących cuboidach.
w związku z tym postem.
Moderator nadzorujący i tak musi być w grze podczas usuwania cuboida i umieszczania przedmiotów w skrzynce.

RE: Utworzenie API fCraft.pl - JanekJaran - 21.07.2017

(21.07.2017, 12:04)Libter napisał(a): Moderator nadzorujący i tak musi być w grze podczas usuwania cuboida i umieszczania przedmiotów w skrzynce.
Chcę zrobić rejestr zawierający wszystkie dane o rozebranym cuboidzie.

RE: Utworzenie API fCraft.pl - Norbi - 05.08.2017

Składam propozycję dodania daty (dzień, miesiąc, rok) do:
  • /{serwer}/cuboid/deleted/{nazwa}: data usunięcia cuboida
  • /{serwer}/version: data wdrożenia (pełnej wersji oraz osobne dla poprawek)


RE: Utworzenie API fCraft.pl - Libter - 17.10.2017

(05.08.2017, 21:44)Norbi napisał(a): Składam propozycję dodania daty (dzień, miesiąc, rok) do:
  • /{serwer}/cuboid/deleted/{nazwa}: data usunięcia cuboida
  • /{serwer}/version: data wdrożenia (pełnej wersji oraz osobne dla poprawek)
Szczegółowe daty związane z wersją serwera są już w /{serwer}/info, data usunięcia cuboida zostanie dodana.

RE: Utworzenie API fCraft.pl - CzarnyRedziu - 28.11.2017

Zgłaszam zapotrzebowanie na wysyłanie pozycji gracza w komendach.

RE: Utworzenie API fCraft.pl - Norbi - 28.11.2017

zglaszam potrzebe dodania komendy /api komendy ktora bedzir wyswietlac liste utworzonych komend wraz z adresami url

RE: Utworzenie API fCraft.pl - Libter - 28.11.2017

(28.11.2017, 11:26)CzarnyRedziu napisał(a): Zgłaszam zapotrzebowanie na wysyłanie pozycji gracza w komendach.
Może załączać parametry x, y, z oraz world tylko w przypadku wykonania komendy z flagą l? Przykład załączenia klucza API/1, API/3 oraz lokalizacji: /api komenda 13l

(28.11.2017, 12:19)Norbi napisał(a): zglaszam potrzebe dodania komendy /api komendy ktora bedzir wyswietlac liste utworzonych komend wraz z adresami url
Swoich czy wszystkich?

RE: Utworzenie API fCraft.pl - CzarnyRedziu - 28.11.2017

(28.11.2017, 12:27)Libter napisał(a):
(28.11.2017, 11:26)CzarnyRedziu napisał(a): Zgłaszam zapotrzebowanie na wysyłanie pozycji gracza w komendach.
Może załączać parametry x, y, z oraz world tylko w przypadku wykonania komendy z flagą l? Przykład załączenia klucza API/1, API/3 oraz lokalizacji: /api komenda 13l

Jestem za.