API: Różnice pomiędzy wersjami

Z Wiki fCraft.pl
Przejdź do nawigacji Przejdź do wyszukiwania
(API/P)
Znacznik: visualeditor
 
Linia 1: Linia 1:
{{Szkic}}
{{Szkic}}'''API''' - oficjalne API serwera fCraft.pl, umożliwiające dostęp do podstawowych danych nt. serwera, wyświetlanie statystyk i manipulację majątkiem. Zwraca odpowiedzi w formacie JSON.
 
<div class="topbox red">
Część funkcji przedstawionych w tym artykule nie została jeszcze wprowadzona na serwer.
</div>
 
'''API''' - oficjalne API fCraft.pl, umożliwiające dostęp do podstawowych danych nt. serwera, wyświetlanie statystyk i manipulację majątkiem. Zwraca odpowiedzi w formacie JSON.
 
== Klucze ==
== Klucze ==
=== Rodzaje kluczy ===
=== Rodzaje kluczy ===
Wyróżnia się 3 rodzaje kluczy:
Wyróżnia się 3 rodzaje kluczy:
# API/0 - klucz możliwy do uzyskania [https://fcraft.pl/temat-wydawanie-kluczy-api-0-1476 w tym wątku]. Umożliwia dostęp do publicznych danych, takich jak informacje nt. serwera czy informacje o usuniętych cuboidach. '''Klucz wymagany przy wszystkich zapytaniach.'''
# API/0 - klucz możliwy do uzyskania [https://fcraft.pl/temat-wydawanie-kluczy-api-0-1476 w tym wątku]. Umożliwia dostęp do publicznych danych, takich jak informacje nt. serwera czy informacje o usuniętych cuboidach. '''Klucz wymagany przy wszystkich zapytaniach z wyjątkiem oznaczonych jako API/P.'''
# API/1 - klucz widoczny po użyciu komendy '''/api'''. Umożliwia dostęp do prywatnych informacji gracza, takich jak np. statystyki.
# API/1 - klucz widoczny po użyciu komendy '''/api'''. Umożliwia dostęp do prywatnych informacji gracza, takich jak np. statystyki.
# API/2 - klucz dostępny po użyciu komendy '''/api'''. Umożliwia manipulację majątkiem gracza.
# API/2 - klucz dostępny po użyciu komendy '''/api'''. Umożliwia manipulację majątkiem gracza.

Aktualna wersja na dzień 16:37, 26 paź 2017

To dopiero zalążek artykułu. Jeśli możesz - rozbuduj go!
Po rozbudowie można usunąć szablon {{Szkic}}.

API - oficjalne API serwera fCraft.pl, umożliwiające dostęp do podstawowych danych nt. serwera, wyświetlanie statystyk i manipulację majątkiem. Zwraca odpowiedzi w formacie JSON.

Klucze

Rodzaje kluczy

Wyróżnia się 3 rodzaje kluczy:

  1. API/0 - klucz możliwy do uzyskania w tym wątku. Umożliwia dostęp do publicznych danych, takich jak informacje nt. serwera czy informacje o usuniętych cuboidach. Klucz wymagany przy wszystkich zapytaniach z wyjątkiem oznaczonych jako API/P.
  2. API/1 - klucz widoczny po użyciu komendy /api. Umożliwia dostęp do prywatnych informacji gracza, takich jak np. statystyki.
  3. API/2 - klucz dostępny po użyciu komendy /api. Umożliwia manipulację majątkiem gracza.

Użycie kluczów w zapytaniu

  1. API/0 - parametr GET (lub POST w przypadku zapytań POST) o nazwie key0.
  2. API/1 - parametr GET (lub POST w przypadku zapytań POST) o nazwie key1.
  3. API/2 - parametr GET (lub POST w przypadku zapytań POST) o nazwie key2.

Dostępne endpointy

Parametry

{serwer} - serwer, którego dotyczy zapytanie - easy albo hard.

/{serwer}/info

  1. version - informacje nt. wersji serwera
    1. version.minecraft - informacje nt. wersji Minecraft
      1. version.minecraft.protocol - wersja protokołu.
      2. version.minecraft.version - wersja Minecrafta.
    2. version.world - informacje nt. aktualnego świata.
      1. version.world.number - liczba porządkowa aktualnego świata.
      2. version.world.date -