summaryrefslogtreecommitdiff
path: root/doc/api-pkl/index.md
diff options
context:
space:
mode:
authorMichał Klichowicz <emkael@tlen.pl>2020-05-16 19:26:26 +0200
committerGitHub <noreply@github.com>2020-05-16 19:26:26 +0200
commitf31b4dbd1af8c58e7c0baa6028d963ce409f5c80 (patch)
tree220a0222021680be80b7124c0453f225360490a3 /doc/api-pkl/index.md
parent2414c05949aa23623d28be99a5a7f39b866342c7 (diff)
parenta5245115ad6ab8c9cfb9d278b753244c1b486d2d (diff)
Merge pull request #4 from PZBS/api-pkl-v3
PKL API v3 docs
Diffstat (limited to 'doc/api-pkl/index.md')
-rw-r--r--doc/api-pkl/index.md12
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/api-pkl/index.md b/doc/api-pkl/index.md
index 05a458a..e49baa4 100644
--- a/doc/api-pkl/index.md
+++ b/doc/api-pkl/index.md
@@ -14,7 +14,7 @@ Parametry (standardowe)
| type | typ turnieju | `1` = indywiduel, `2` = pary, `4` = teamy |
| contestants | liczba uczestników | liczba całkowita dodatnia |
| title_sum | suma WK | liczba nieujemna |
-| tournament_rank | ranga turnieju | `0` = klubowy, `1` = okręgowy, `2` = regionalny, `3` = OTX, `4` = OTX\*, `5` = OTX\*\*, `6` = OTX\*\*\*, `7` = OTX\*\*\*\*, `101` = KMP |
+| tournament_rank | ranga turnieju | `0` = klubowy, `1` = okręgowy, `2` = regionalny, `3` = OTX, `4` = OTX\*, `5` = OTX\*\*, `6` = OTX\*\*\*, `7` = OTX\*\*\*\*, `101` = KMP, `102` = BridgeNET Lokalny |
| over39_boards | liczba rozdań | `0` = mniejsza niż 40, `1` = co najmniej 40 |
W standardowym trybie użycia API wszystkie powyższe parametry są obowiązkowe.
@@ -25,12 +25,16 @@ API przyjmuje również opcjonalne parametry:
| -------- | ----------------- | -------- | ---------------- |
| players | liczba zawodników | liczba całkowita dodatnia | `contestants` \* `type` |
| version | wersja regulaminu | patrz poniżej | `'2'` |
+| boards | liczba rozdań | liczba całkowita nieujemna |
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:
+Parametr `boards` może przesłonić wartość parametru `over39_boards`, jest on poza tym **obowiązkowy** dla turniejów typu BridgeNET Lokalny (`tournament_rank` = `102`).
+
+Parametr `version` pozwala na określenie wersji Regulaminu Klasyfikacyjnego (lub regulaminów zawodów) 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
+ * `'2'` - Regulamin Klasyfikacyjny 01.11.2018, Regulamin KMP od 01.01.2020
+ * `'3'` (domyślna) - Regulamin Klasyfikacyjny od kwietnia 2020, Regulamin KMP od 01.01.2020, Regulamin BridgeNET Lokalny od 01.05.2020
Wartością domyślną jest **zawsze** wartość odpowiadająca bieżącemu stanowi prawnemu.
@@ -54,6 +58,8 @@ W przypadku podania zarówno parametru `manual[min_points]`, jak i `manual[tourn
Dla turniejów o randze KMP powyższe parametry, jak i parametr liczby rozdań, są ignorowane (ale API wciąż wymaga podania parametrów `over39_boards`).
+Dla turniejów w randze BridgeNET Lokalny powyższe parametry są ignorowane.
+
Przykładowe zapytania do API
----------------------------