Požadavek login
Zalogování uživatele se získáním session id.
Požadavek pro založení session na straně serveru, která je v podobě session ID vrácena v odpovědi a jejím umístěním do další obálky request jako atribut session se provádí tento požadavek v rámci dané session.
Kombinace login požadavku jako prvního v obálce request a logout požadavku jako posledního v obálce je možné požadavky mezi login a logout provádět v rámci nové session a kód session pak není nutné umisťovat do atributu ression uzlu request.
<request>
<login/>
</request>
Atributy
Požadavek login neobsahuje žádné atributy.
Potomci
Požadavek login neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.
Odpověď
Struktura odpovědi na požadavek login vrácená v obálce response:
<response>
<login
type="ok|error"
session="{string}"
lang="{string}"
auth="{string}"
/>
</response>
Atributy
-
type- Obsahuje hodnoty ok nebo error (možnosti obsahu:ok | error) -
session- Hexadecimální id seance zalogovaného uživatele.(typ: string) TYP HODNOTY:string; -
lang- Dvouznakový jazykový kód uživatele (cs|en|...)(typ: string) TYP HODNOTY:string; -
auth- Auth řetězec.(typ: string) TYP HODNOTY:string;
Potomci
Odpověď login neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.
Výraz pro identifikaci chyb v odpovědi serveru: rand[@type='error'] (odkaz na popis detailu: @details).