taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

post-management-denominations-H_DENOM_PUB-revoke.rst (1129B)

      1 .. http:post:: /management/denominations/$H_DENOM_PUB/revoke
      2 
      3   Revoke denomination key, preventing further use by the exchange.
      4   Only to be used by the exchange's offline key management team. Not useful
      5   for anyone else.
      6 
      7   **Request:**
      8 
      9   The request body must be a `DenomRevocationSignature` object.
     10 
     11   **Response:**
     12 
     13   :http:statuscode:`204 No content`:
     14     The request was successfully processed.
     15   :http:statuscode:`403 Forbidden`:
     16     The provided signature is invalid.
     17     Returned with an error code of
     18     ``TALER_EC_EXCHANGE_MANAGEMENT_DENOMINATION_REVOKE_SIGNATURE_INVALID``.
     19   :http:statuscode:`500 Internal Server Error`:
     20     The server experienced an internal error.
     21     This response comes with a standard `ErrorDetail` response with
     22     a code of ``TALER_EC_GENERIC_DB_STORE_FAILED``.
     23 
     24   **Details:**
     25 
     26   .. ts:def:: DenomRevocationSignature
     27 
     28     interface DenomRevocationSignature {
     29 
     30       // Signature by the exchange master key over a
     31       // `TALER_MasterDenominationKeyRevocationPS`.
     32       // Must have purpose ``TALER_SIGNATURE_MASTER_DENOMINATION_KEY_REVOKED``.
     33       master_sig: EddsaSignature;
     34 
     35     }