Požadavek register
Příklady použití požadavku pro registraci k pozdějšímu použití prostřednictvím běžného HTTP GET požadavku.
1. Provede s službami uvedenými atributu akci dle parametru v GET požadavku. Požadavek lze provést maximálně 10x, nejpozději však 31.12.2020 v 11:59:59 (zruší jej omezení, které nastane dříve). Jako odpověď bude vrácena pokusná fsp stránka pokus.fsp, umístěná v rootu webu, které je předán parametr action=services.
<register type="Pokusna registrace" what="1" count="10" till="2020-01-31T11:59:59" response="pokus.fsp?action=services">
<service name="mail" action="[stop]"/>
<service name="web" action="[stop]"/>
</register>
2. Totéž, ale jinak. Dále také ukazuje, že atribut what není pro běžné registrace povinný.
<register type="Pokusna registrace" count="10" till="2020-01-31T11:59:59" response="pokus.fsp?action=services">
<request>
<service name="mail" action="[stop]"/>
<service name="web" action="[stop]"/>
</request>
</register>
3. Umožnění 10 přihlášení pod uživatelem 11.
<register type="Pokusna registrace" what="1" login="11" count="10" till="2020-01-31T11:59:59" response="pokus.fsp?action=services">
4. Vytvoření nového uživatele a následné přihlášení. Umožní 9 dalších přihlášení pod tímto uživatelem, další uživatele již nevytvoří.
<register type="Pokusna registrace" what="1" count="10" till="2020-01-31T11:59:59" response="pokus.fsp?action=services">
<request>
<save-document>
<...>
</save-document>
</request>
</register>
Odpověď:
Jako u většiny požadavků existují i zde dvě možné odpovědi - kladná a záporná. Kladná značí, že požadavek byl řádně proveden, záporná pak, že při jeho provádění došlo k nějaké chybě.
Kladná:
<register status="ok" register-type="Pokusna registrace" ref="4511009b6f4fccc67cd80557c3085171" />
Záporná:
Chybová odpověď vždy obsahuje popis chyby.
<register status="error" descr="Popis chyby">
...
</register>
V případě databázové chyby, jsou v těle tagu přítomny tagy error (viz tag error) s popisem databázové chyby (chyb).
Význam jednotlivých atributů:
status - vždy hodnota error
descr - Popis chyby
Popis požadavku viz. register.