Požadavek register-del

Účel a dopady

Provede logický výmaz registrovaného požadavku podle jeho ref (viz register).

Dostupnost, kontext, oprávnění apod.

• r_admin smí smazat jakoukoli registraci bez ověřování vlastnictví.
• Ostatní uživatelé smí smazat jen vlastní registraci (uid uložený u registrace se musí shodovat s ID volajícího) – jinak je požadavek zamítnut.

XML požadavek (syntax + popis)

  <request>
   <register-del
    ref="{string}"
    />
  </request>

Parametry a pravidla (atributy, potomci)

• ref - Hexadecimální identifikátor registrace k výmazu. (typ: string; povinný – chybí-li, požadavek skončí chybou)

Požadavek nemá žádné potomky.

Význam neexistujícího ref

Neexistuje-li zadaný ref a volající není r_admin, server to nepovažuje za chybu a vrátí status="ok" beze změny. U r_admin se ověření vlastnictví neprovádí vůbec, výmaz jde přímo do databázové procedury.

Příklady požadavku

(Zatím bez ověřeného příkladu.)

Zpracování a vedlejší účinky

U uživatele bez role správce proběhne nejprve ověření existence a vlastnictví, teprve poté samotný výmaz. U správce se ověření vlastnictví přeskakuje.

XML odpověď (syntax + popis)

  <response>
   <register-del
    status="ok|error"
    detail="{string}"
    />
  </response>

Příklady odpovědi

(Zatím bez ověřeného příkladu.)

Chyby a reakce

• status="error" detail="Nespravne zadany parametr ref" – chybí ref, nebo (u non-admina) ref patří jinému uživateli.
• status="error" detail="Pri provadeni pozadavku doslo k chybe" – selhání na úrovni ověření/výmazu; tato větev není sebeuzavírající a může nést vnořené error.

Související požadavky

• register, register-list, perform-register.