taler-docs

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

get-monitoring-progress.rst (1210B)

      1 .. http:get:: /monitoring/progress
      2 
      3   Get the progress stored by the auditor.
      4 
      5   **Request:**
      6 
      7   :query progress_key: a string identifying a progress point. If specified, only returns the element with this exact key. The default value is NULL.
      8 
      9 
     10   **Response:**
     11 
     12   :http:statuscode:`200 OK`:
     13     The auditor responds with a top level array of :ts:type:`Progress` objects. If no elements could be found, an empty array is returned
     14   :http:statuscode:`400 Bad request`:
     15     The request is malformed. Returned with an
     16     ``TALER_EC_GENERIC_PARAMETER_MALFORMED`` error code.
     17   :http:statuscode:`401 Unauthorized`:
     18     The request lacks valid authentication credentials.
     19     The response comes with a ``TALER_EC_AUDITOR_GENERIC_UNAUTHORIZED``.
     20   :http:statuscode:`500 Internal Server Error`:
     21     The server experienced an internal error.
     22     The response comes with a ``TALER_EC_GENERIC_DB_SETUP_FAILED`` or
     23     ``TALER_EC_GENERIC_DB_FETCH_FAILED`` error code.
     24 
     25   **Details:**
     26 
     27   .. ts:def:: Progress
     28 
     29     interface Progress {
     30 
     31       // Key associated with a given progress point
     32       progress_key: string;
     33 
     34       // How much of the exchanges data has been processed so far
     35       progress_offset: Integer;
     36 
     37     }