Požadavek change-password
Změna hesla uživatele
Požadavek pro změnu přístupového hesla uživatele do systému. Slouží především pro potřeby změny hesla samotným uživatelem.
<request><change-passwordid="{number}"old="{string}"new="{string}"hash="{boolean}"/></request>
Atributy

id - číslo uživatele - User ID pro správnou identifikaci souboru nastavení (statistiky).(typ: number)

old - Původní heslo - Znění původního hesla pro potvrzení oprávněnosti změny.(typ: string) TYP HODNOTY: string;

new - Nové heslo - Zadání nového hesla pro další přístupy.(typ: string) TYP HODNOTY: string;

hash - Převod vstupních dat - Funkce pro převod vstupních dat do malého čísla(typ: boolean) TYP HODNOTY: boolean;
Potomci
Požadavek change-password neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.
Poznámka k request
Není=li uveden atribut id, pak dojde ke změně vlastního hesla. Pokud je atribut id uveden (bez ohledu na jeho hodnotu) pak se jedná o pokus o administrátorskou změnu hesla. Jak už sám název napovídá, tuto změnu může provést pouze uživatel s oprávněním administrátora.
Je-li atribut "hash" uveden a ma hodnotu true, pak v attributu "new" (nove heslo) je ocekavan hash hesla, nikoli textove heslo.
Hash hesla je ocekavan hexadecimalnim tvaru a je kontrolovan. Kontrolovana je jednak prevoditelnost z hexa do bin a jednak delka. Delka musi presne odpovidat delce pouzivaneho hash.
Odpověď
Struktura odpovědi na požadavek change-password vrácená v obálce response:
<response><change-passwordtype="ok|error"detail="{string}"/></response>
Atributy

type - Obsahuje hodnoty ok nebo error (možnosti obsahu: ok | error)

detail - Upřesnění - Bližší popis vzniklé chyby. Je k dispozici při odpovědi typu 'error'.(typ: string)
Potomci
Odpověď change-password neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.
Výraz pro identifikaci chyb v odpovědi serveru: user-details[@type='error'] (odkaz na popis detailu: @detail).

