summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authoremkael <emkael@tlen.pl>2020-01-10 22:59:07 +0100
committeremkael <emkael@tlen.pl>2020-01-10 22:59:07 +0100
commit791d1c92f3d4de54eeb597b6e5c228e3315a7622 (patch)
tree25fb5e31b6dfb3ea30d57ee43ae49de5a70f56fc /doc
parent3f7e193e8760a3caf32f5e299bfe98845eaee39a (diff)
Dokumentacja API PKL - wersjonowanie
Diffstat (limited to 'doc')
-rw-r--r--doc/api-pkl/index.md13
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/api-pkl/index.md b/doc/api-pkl/index.md
index 42aed43..05a458a 100644
--- a/doc/api-pkl/index.md
+++ b/doc/api-pkl/index.md
@@ -19,20 +19,27 @@ Parametry (standardowe)
W standardowym trybie użycia API wszystkie powyższe parametry są obowiązkowe.
-API przyjmuje również opcjonalny parametr:
+API przyjmuje również opcjonalne parametry:
| Parametr | Opis | Wartości | Wartość domyślna |
| -------- | ----------------- | -------- | ---------------- |
| players | liczba zawodników | liczba całkowita dodatnia | `contestants` \* `type` |
+| version | wersja regulaminu | patrz poniżej | `'2'` |
-Paramter ten służy do wyliczenia prawidłowego średniego WK dla turniejów teamów nieczteroosobowych. Jest on używany *tylko* do wyliczenia średniego WK, drugi składnik maksymalnej liczby PKL dla turnieju wciąż wyliczany jest zgodnie z pkt. 9 Regulaminu Klasyfikacyjnego - jako `contestants` \* `type`.
+Paramter `players` służy do wyliczenia prawidłowego średniego WK dla turniejów teamów nieczteroosobowych. Jest on używany *tylko* do wyliczenia średniego WK, drugi składnik maksymalnej liczby PKL dla turnieju wciąż wyliczany jest zgodnie z pkt. 9 Regulaminu Klasyfikacyjnego - jako `contestants` \* `type`.
+
+Parametr `version` pozwala na określenie wersji Regulaminu Klasyfikacyjnego (lub Regulaminu KMP) według którego wyliczane są PKLe. Dozowolone wartości:
+ * `'1'` - Regulamin Klasyfikacyjny 01.11.2018, Regulamin KMP sprzed 01.01.2020
+ * `'2'` (domyślna) - Regulamin Klasyfikacyjny 01.11.2018, Regulamin KMP od 01.01.2020
+
+Wartością domyślną jest **zawsze** wartość odpowiadająca bieżącemu stanowi prawnemu.
Parametry (zaawansowane)
------------------------
API akceptuje również parametry pozwalające ręcznie ustalić wagę turnieju, minimum PKL za pierwszej miejsce oraz parametry funkcji obliczającej PKL.
-Wszystkie zaawansowane paramtery przekazywane są w zminnej HTTP `manual`.
+Wszystkie zaawansowane paramtery przekazywane są w zmiennej HTTP `manual`.
| Parametr | Opis | Wartości | Wartość domyślna |
| -------- | ----------------- | -------- | ---------------- |